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Advance Praise for Head First C 


“Head First C could quite possibly turn out to be the best G book of all time. I don’t say that lightly. I could 
easily see this become the standard G textbook for every college G course. Most books on programming 
follow a fairly predictable course through keywords, control-flow constructs, syntax, operators, data types, 
subroutines, etc. These can serve as a useful reference, as well as a fairly academic introduction to the 
language. This book, on the other hand, takes a totally different approach. It teaches you how to be a 
real G programmer. I wish I had had this book 15 years ago!” 

— Dave Kitabjian，Director of Software Development，NetCarrier Telecom 


“Head First C is an accessible, light-hearted introduction to G programming, in the classic Head First style. 
Pictures, jokes, exercises, and labs take the reader gently but steadily through the fundamentals of G — 
including arrays, pointers, structs, and functions — before moving into more advanced topics in Posix and 
Linux system programming, such as processes and threads.” 

— Vince Milner, software developer 




Praise for other Head First books 


“Kathy and Bert’s Head First Java transforms the printed page into the closest thing to a GUI you’ve ever 
seen. In a wry, hip manner, the authors make learning Java an engaging ‘what’re they gonna do next?’ 
experience.” 

— Warren Keuffel, Software Development Magazine 


“Beyond the engaging style that drags you forward from know-nothing into exalted Java warrior status, 
Head First Java covers a huge amount of practical matters that other texts leave as the dreaded 'exercise 
for the reader".’ It’s clever, wry, hip, and practical — there aren’t a lot of textbooks that can make that claim 
and live up to it while also teaching you about object serialization and network launch protocols. ’’ 

— Dr. Dan Russell, Director of User Sciences and Experience Research, 

IBM Almaden Research Center; 

artificial intelligence instructor, Stanford University 


“It’s fast, irreverent, fun, and engaging. Be careful~you might actually learn something!” 

— Ken Arnold, former Senior Engineer at Sun Microsystems; 
coauthor (with James Gosling，creator of Java), 

The Java Programming Language 


“I feel like a thousand pounds of books have just been lifted off of my head.” 

— Ward Cunningham，inventor of the Wiki and founder of the Hillside Group 


£ Just the right tone for the geeked-out, casual-cool guru coder in all of us. The right reference for 
practical development strategies — gets my brain going without having to slog through a bunch of 
tired, stale professor-speak.” 

— Travis Kalanick, founder of Scour and Red Swoosh; 
member of the MIT TR100 


“There are books you buy, books you keep, books you keep on your desk, and thanks to O’Reilly and the 
Head First crew, there is the penultimate category, Head First books. They’re the ones that are dog-eared, 
mangled, and carried everywhere. Head First SQL is at the top of my stack. Heck, even the PDF I have 
for review is tattered and torn.” 

— Bill Sawyer, ATG Curriculum Manager, Oracle 


“This book’s admirable clarity, humor, and substantial doses of clever make it the sort of book that helps 
even nonprogrammers think well about problem solving.” 

— Cory Doctorow，coeditor of Boing Boing; 
author, Dozvn and Out in the Magic Kingdom 
and Someone Comes to Town，Someone Leaves Town 


Praise for other Head First books 


“I received the book yesterday and started to read it.. .and I couldn’t stop. This is definitely tres ‘cool.’ It 
is fun, but they cover a lot of ground, and they are right to the point. I’m really impressed.” 

— Erich Gamma, IBM Distinguished Engineer and coauthor of Design Patterns 


“One of the funniest and smartest books on software design I’ve ever read.” 

— Aaron LaBerge，VP Technology, ESPN.com 


“What used to be a long trial-and-error learning process has now been reduced neatly into an engaging 
paperback.” 

— Mike Davidson ， CEO, Newsvine ， Inc. 


“Elegant design is at the core of every chapter here, each concept conveyed with equal doses of 
pragmatism and wit.’’ 

— Ken Goldstein，Executive Vice President，Disney Online 

“IV Head First HTML with CSS & XHTML — it teaches you everything you need to learn in a Tun coated’ 
format.” 


— Sally Applin, UI designer and artist 


“Usually when reading through a book or article on design patterns, I’d have to occasionally stick myself 
in the eye with something just to make sure I was paying attention. Not with this book. Odd as it may 
sound, this book makes learning about design patterns fun. 

u While other books on design patterns are saying c Bueller.. .Bueller.. .Bueller..this book is on the float 
belting out 'Shake it up, baby!”’ 

— Eric Wuehler 

“I literally love this book. In fact, I kissed this book in front of my wife.” 


— Satish Kumar 
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David Griffiths began programming at age 12, 
when he saw a documentary on the work of Seymour 
Papert. At age 15, he wrote an implementation of 
Papert’s computer language LOGO. After studying 
pure mathematics at university, he began writing code 
for computers and magazine articles for humans. He’s 
worked as an agile coach, a developer, and a garage 
attendant, but not in that order. He can write code 
in over 10 languages and prose in just one, and when 
not writing, coding, or coaching, he spends much 
of his spare time traveling with his lovely wife — and 
coauthor — Dawn. 

Before writing Head First C, David wrote two other 
Head First books: Head First Rails and Head First 
Programming. 

You can follow David on Twitter at 


Dawn Griffiths started life as a mathematician at 
a top UK university, where she was awarded a first-class 
honors degree in mathematics. She went on to pursue 
a career in software development and has over 15 years 
experience working in the IT industry. 

Before joining forces with David on Head First C, Dawn 
wrote two other Head First books (Head First Statistics 
and Head First 2D Geometry) and has also worked on a 
host of other books in the series. 

When Dawn’s not working on Head First books, you’ll 
find her honing her Tai Chi skills, running, making 
bobbin lace, or cooking. She also enjoys traveling and 
spending time with her husband, David. 


http:/ / twitter.com/ dogriffiths. 
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getting started WitL C 

Diving in 


Want to get inside the computer’s head? 

Need to write high-performance code for a new game? Program an Arduino? Or 
use that advanced third-party library in your iPhone app? If so, then C’s here to 
help. C works at a much lower level than most other languages, so understanding 
C gives you a much better idea of what’s really going on. C can even help you better 
understand other languages as well. So dive in and grab your compiler, and you’ll soon 
get started in no time. 


G is a language for small, fast programs 

But what does a complete G program look like? 

But how do you run the program? 
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memory and pointers 

What are you pointing at? 

If you really want to kick butt with C, you need to understand 
how C handles memory. 

The C language gives you a lot more control over how your program uses the 
computer’s memory. In this chapter, you’ll strip back the covers and see exactly what 
happens when you read and write variables. You’ll learn how arrays work, how 
to avoid some nasty memory SNAFUs, and most of all, you’ll see how mastering 
pointers and memory addressing is key to becoming a kick-ass C programmer. 
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strings 

String theory 

There’s more to strings than reading them. 

You’ve seen how strings in C are actually char arrays but what does C allow you to do 
with them? That’s where string.h comes in. string.h is part of the C Standard Library 
that’s dedicated to string manipulation. If you want to concatenate strings together, 
copy one string to another, or compare two strings, the functions in string.h are there 
to help. In this chapter, you’ll see how to create an array of strings, and then take a 
close look at how to search within strings using the strstr () function. 
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creqtln^ small 物 Is 

o one thing and do it well 

very operating system includes small tools. 

Small tools written in C perform specialized small tasks, such as reading and 
riting files, or filtering data. If you want to perform more complex tasks, you 
can even link several tools together. But how are these small tools built? In this 
chapter, you’ll look at the building blocks of creating small tools. You’ll learn how 
to control command-line options, how to manage streams of information, and 
redirection, getting tooled up in no time. 
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multiple source files 

Break it down, build it up 

If you create a big program, you don’t want a big source file. 

Can you imagine how difficult and time-consuming a single source file for an enterprise- 
level program would be to maintain? In this chapter, you’ll learn how C allows you to 
break your source code into small, manageable chunks and then rebuild them into 
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and get to meet your new best friend: make. 
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structs, unions, and tftfielJs 

Rolling your own structures 

t Most things in life are more complex than a simple number. 

• I So far, you’ve looked at the basic data types of the C language, but what if you 

want to go beyond numbers and pieces of text, and model things in the real 
world? structs allow you to model real-world complexities by writing your own 
structures. In this chapter, you’ll learn how to combine the basic data types into 
structs, and even handle life’s uncertainties with unions. And if you’re after a 
simple yes or no, bitfields may be just what you need. 

Sometimes you need to hand around a lot of data 218 
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Building bridges 

Sometimes, a single struct is simply not enough. 

To model complex data requirements, you often need to link structs together. In 
this chapter, you’ll see how to use struct pointers to connect custom data types into 
large, complex data structures. You’ll explore key principles by creating linked lists. 


You’ll also see how to make your data structures cope with flexible amounts of data by 


dynamically allocating memory on the heap, and freeing it up when you’re done. And 
if good housekeeping becomes tricky, you’ll also learn how valgrind can help. 
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Jurn your functions up to 11 

Basic functions are great, but sometimes you need more. 

So far, you’ve focused on the basics, but what if you need even more power and 
flexibility to achieve what you want? In this chapter, you’ll see how to up your 


code’s IQ by passing functions as parameters. You’ll find out how to get things 
sorted with comparator functions. And finally, you’ll discover how to make your 
code super stretchy with variadic functions. 
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static and dynamic libraries 

Hot-swappable code 

You’ve already seen the power of standard libraries. 

Now it’s time to use that power for your own code. In this chapter, you’ll see how to 
create your own libraries and reuse the same code across several programs. 
What’s more, you’ll learn how to share code at runtime with dynamic libraries. You’ll 
learn the secrets of the coding gurus. And by the end of the chapter, you’ll be able to 
write code that you can scale and manage simply and efficiently. 
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intruder detector using the cleverness of OpenCV. 
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processes and system calls 

Breaking boundaries 

It’s time to think outside the box. 

You’ve already seen that you can build complex applications by connecting small 
tools together on the command line. But what if you want to use other programs 
from inside your own code? In this chapter, you’ll learn how to use system 
services to create and control processes. That will give your programs access to 
email, the Web, and any other tool you J ve got installed. By the end of the chapter, 
you’ll have the power to go beyond C. 
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interprocess cpmniunicqtipn 

It’s good to talk 

Creating processes is just half the story. 

What if you want to control the process once it’s running? What if you want to send it 
data? Or read its output? Interprocess communication lets processes work together 
to get the job done. We’ll show you how to multiply the power of your code by letting it 
talk to other programs on your system. 


#include <stdio.h> 

int main() 

{ ， 
char name[30]; 
printf ( "Enter your name : ’▼) 
fgets(name, 30, stdin); 
printf("Hello %s\n n , name); 
return 0; 
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sockets and netWprkirL^ 

There’s no place like 127.0.0.1 

Programs on different machines need to talk to each other. 

You’ve learned how to use I/O to communicate with files and how processes on the 
same machine can communicate with each other. Now you’re going to reach out 
to the rest of the world, and learn how to write C programs that can talk to other 
programs across the network and across the world. By the end of this chapter, 
you’ll be able to create programs that behave as servers and programs that 
behave as clients. 
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threads 

It’s a parallel world 

Programs often need to do several things at the same time. 

POSIX threads can make your code more responsive by spinning off several pieces 
of code to run in parallel. But be careful! Threads are powerful tools, but you don’t 
want them crashing into each other. In this chapter, you’ll learn how to put up traffic 
signs and lane markers that will prevent a code pileup. By the end, you will know 
how to create POSIX threads and how to use synchronization mechanisms to 
protect the integrity of sensitive data. 
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tWcads addessm^ -bV^c same 
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CLab3 

Blasteroids 

In this lab, you’re going to pay tribute to one of the 
most popular and. long-lived, video games of them all. 
It’s time to write Blasteroids! 







table of contents 


leftovers 



The top ten things (we didn’t cover) 

ven after all that, there’s still a bit more. 

here are just a few more things we think you need to know. We wouldn’t feel right 
bout ignoring them, even though they need only a brief mention, and we really wanted 
to give you a book you’d be able to lift without extensive training at the local gym. So 



before you put the book down, read through these tidbits. 


#1. Operators 
#2. Preprocessor directives 
#3. The static keyword 
#4. How big stuff is 
#5. Automated testing 
#6. More on gcc 


#7. More on make 


#8. Development tools 
#9. Creating GUIs 
#10. Reference material 
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c topics 



Revision roundup 

Ever wished all those great C facts were in one place? 

This is a roundup of all the C topics and principles we’ve covered in the book. Take a 
look at them, and see if you can remember them all. Each fact has the chapter it came 
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from alongside it, so it’s easy for you to refer back if you need a reminder. You might 
even want to cut these pages out and tape them to your wall. 


JiP\V tP use this book 

Intro 





















how to use this book 


Who is this book for? 


If you can answer “yes” to all of these: 


Do you already know how to program in another 
programming language? 

f?% Do you want to master C, create the next big thing in 
software, make a small fortune, and retire to your own 
private island? 

Do you prefer actually doing things and applying the stuff 
you learn over listening to someone in a lecture rattle on 
for hours on end? 


this book is for you. 


Who should probably back away from this book? 

If you can answer “yes” to any of these: 


o 

❺ 


Are you looking for a quick introduction or reference book 
to C? 

Would you rather have your toenails pulled out by 15 
screaming monkeys than learn something new? Do you 
believe a C book should cover everything and if it bores 
the reader to tears in the process, then so much the 
better? 


this book is not for you. 



^ Mav-kctmg ： -this book 
,s 如 yow/ith 〜 edit ^av-d... 
wcl1 a 仏比 k, iooJ 
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the intro 


Wc know what youVe thinking 


“How can this be a serious G book? 
“What’s with all the graphics?” 
“Can I actually learn it this wa 


55 




Wc know what your brain is thinking 

Your brain craves novelty. It’s always searching, scanning, waiting for something 
unusual. It was built that way, and it helps you stay alive. 

So what does your brain do with all the routine, ordinary, normal things 
you encounter? Everything it can to stop them from interfering with the 
brain’s real]oh — recording things that matter. It doesn’t bother saving the 
boring things; they never make it past the “this is obviously not important 
filter. 

How does your brain know what’s important? Suppose you’re out for a day 
hike and a tiger jumps in front of you — what happens inside your head and 
body? 

Neurons fire. Emotions crank up. Chemicals surge. 

And that’s how your brain knows"• 

This must be important! Don’t forget it! 

But imagine you’re at home or in a library. It’s a safe, warm, tiger-free zone. \!o^c 
You’re studying. Getting ready for an exam. Or trying to learn some tough 丁 \\\ 幺 ' SV) 

technical topic your boss thinks will take a week, ten days at the most. 

Just one problem. Your brain’s trying to do you a big favor. It’s trying to make 
sure that this obviously unimportant content doesn’t clutter up scarce resources. 
Resources that are better spent storing the really big things. Like tigers. 

Like the danger of fire. Like how you should never have posted those 
party photos on your Facebook page. And there’s no simple way 
to tell your brain, “Hey brain, thank you very much, but no matter 
how dull this book is, and how little I’m registering on the emotional 
Richter scale right now, I really do want you to keep this stuff around.’’ 
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We tei o£ a “Head Ftfsf reader as a 

s 。— 。 二： st 

you don，t forget \t IVs not about P^^mg fa psychology, learn,ng 

research in cognitive science your brain on. 

takes a lot more than text on a page. We 


Some of the Head First learning principles: 


Some ot me ■ 一 

more effective (up to 89% improvement in re d ^ raphic s they relate to, rather than on 

r ； r:— 

:：： 。一一 —： 

to 400/0 better on post-learning tests lf th : Tel| stories instea d of lecturing. Use casual language. 

COmPani °"° ra，eCtUre? deeply .noth, words, uniess you active,y flex 

Get the learner to think mo ；； e ^ motivated , engaged, curious, and insured to 

nothing much happens in your head r knowledge. And for that, you need challenges, 

Get-iriep-the reacer-s attention . :：:二 the ordinlrT' 

f tay a—e te^ca, t o Pi caoesn, h a V e t o b e 

interesting, strange, eye-catching, u t 

boring. Your brain wi„ .earn m uch more q u,c ^脈 • 顏咖叫 is _ ely dependent 

Touch their emotions- We now know that your ability to when you feel something. 

二 s emotional content. You _ 二 =;= dog. We.e talking emotions like 

No , we^re not talking hea : 二 the feeling 0 n ruler that comes when you solve a 

^^Tev^ybX delinks is hard, or realize you know something that I m more tec 
thou^Bob from Engineering doesn t. 
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the intro 


Metacognition: thinking about thinking 

If you really want to learn, and you want to learn more quickly and more 
deeply, pay attention to how you pay attention. Think about how you think. 
Learn how you learn. 

Most of us did not take courses on metacognition or learning theory when we 
were growing up. We were expected to learn, but rarely taught to learn. 


I wonder how 
I can trick my brain 
into remembering 
this stuff... 



The trick is to get your brain to see the new material you’re learning as 
Really Important. Crucial to your well-being. As important as a tiger. 
Otherwise, you’re in for a constant battle, with your brain doing its best to 
keep the new content from sticking. 


But we assume that if you’re holding this book, you really want to learn how 
to program in G. And you probably don’t want to spend a lot of time. If you 
want to use what you read in this book, you need to remember what you read. 
And for that, you’ve got to understand it. To get the most from this book, or any 
book or learning experience, take responsibility for your brain. Your brain on 
this content. 


So just how DO you get your brain to treat 
programming like it was a hungry tiger? 


There’s the slow, tedious way, or the faster, more effective way. The 
slow way is about sheer repetition. You obviously know that you are able to learn 
and remember even the dullest of topics if you keep pounding the same thing into your 
brain. With enough repetition, your brain says, “This doesn’t feel important to him, but he 
keeps looking at the same thing over and over and over, so I suppose it must be.” 


The faster way is to do anything that increases brain activity, especially different 
types of brain activity. The things on the previous page are a big part of the solution, 
and they’re all things that have been proven to help your brain work in your favor. For 
example, studies show that putting words within the pictures they describe (as opposed to 
somewhere else in the page, like a caption or in the body text) causes your brain to try to 
makes sense of how the words and picture relate, and this causes more neurons to fire. 
More neurons firing = more chances for your brain to get that this is something worth 
paying attention to, and possibly recording. 


A conversational style helps because people tend to pay more attention when they 
perceive that they’re in a conversation, since they’re expected to follow along and hold up 
their end. The amazing thing is, your brain doesn’t necessarily care that the “conversation” 
is between you and a book! On the other hand, if the writing style is formal and dry, your 
brain perceives it the same way you experience being lectured to while sitting in a roomful 
of passive attendees. No need to stay awake. 


But pictures and conversational style are just the beginning... 
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Here's what WE did: 

We used pictures, because your brain is tuned for visuals, not text. As far as your brain’s 
concerned, a picture really is worth a thousand words. And when text and pictures work 
together, we embedded the text in the pictures because your brain works more effectively 
when the text is within the thing it refers to, as opposed to in a caption or buried in the body 
text somewhere. 

We used redundancy : saying the same thing in different ways and with different media types, 
and multiple senses, to increase the chance that the content gets coded into more than one area 
of your brain. 

We used concepts and pictures in unexpected ways because your brain is tuned for novelty, 
and we used pictures and ideas with at least some emotional content, because your brain 
is tuned to pay attention to the biochemistry of emotions. That which causes you to feel 
something is more likely to be remembered, even if that feeling is nothing more than a little 

humor, surprise, or interest. 


We used a personalized, conversational style, because your brain is tuned to pay more 
attention when it believes you’re in a conversation than if it thinks you’re passively listening 
to a presentation. Your brain does this even when you’re reading. 


We included more than 80 activities ， because your brain is tuned to learn and remember 
more when you do things than when you read about things. And we made the exercises 
challenging-yet-doable, because that’s what most people prefer. 

We used multiple learning styles, because joz/ might prefer step-by-step procedures, while 
someone else wants to understand the big picture first, and someone else just wants to see 
an example. But regardless of your own learning preference, everyone benefits from seeing the 
same content represented in multiple ways. 

We include content for both sides of your brain, because the more of your brain you 
engage, the more likely you are to learn and remember, and the longer you can stay focused. 
Since working one side of the brain often means giving the other side a chance to rest, you 
can be more productive at learning for a longer period of time. 

And we included stories and exercises that present more than one point of view ， 
because your brain is tuned to learn more deeply when it’s forced to make evaluations and 
judgments. 

We included challenges, with exercises, and by asking questions that don’t always have 
a straight answer, because your brain is tuned to learn and remember when it has to work at 
something. Think about it — you can’t get your body in shape just by watching people at the 
gym. But we did our best to make sure that when you’re working hard, it’s on the right things. 
TYidityou^re not spending one extra dendrite processing a hard-to-understand example, 
or parsing difficult, jargon-laden, or overly terse text. 

We people. In stories, examples, pictures, etc., because, well, j 似 Ye a person. And your 
brain pays more attention to people than it does to things. 
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Here's what YOU caw do to bend 
your brain into submission 

So, we did our part. The rest is up to you. These tips are a 
starting point; listen to your brain and figure out what works 
for you and what doesn’t. Try new things. 

Cut -this out 3hd sti 乙 k ii 
° h y ° 你 


o Slow down. The more you understand, the 
less you have to memorize. 

Don’t just read. Stop and think. When the book asks 
you a question, don’t just skip to the answer. Imagine 
that someone really is asking the question. The 
more deeply you force your brain to think, the better 
chance you have of learning and remembering. 

Do the exercises. Write your own notes. 

We put them in, but if we did them for you, that 
would be like having someone else do your workouts 
for you. And don’t just look at the exercises. Use a 
pencil. There’s plenty of evidence that physical 
activity while learning can increase the learning. 

❺ Read “There Are No Dumb Questions.” 

That means all of them. They’re not optional 
sidebars, they ’re part of the core content! 

Don’t skip them. 


o Drink water. Lots of it. 

Your brain works best in a nice bath of fluid. 
Dehydration (which can happen before you ever 
feel thirsty) decreases cognitive function. 

o Listen to your brain. 

Pay attention to whether your brain is getting 
overloaded. If you find yourself starting to skim 
the surface or forget what you just read, it’s time 
for a break. Once you go past a certain point, you 
won’t learn faster by trying to shove more in, and 
you might even hurt the process. 

o Feel something. 

Your brain needs to know that this matters. Get 
involved with the stories. Make up your own 
captions for the photos. Groaning over a bad joke 
is still better than feeling nothing at all. 


Make this the last thing you read before bed. 
Or at least the last challenging thing. 


Part of the learning (especially the transfer to 
long-term memory) happens afteryow. put the book 
down. Your brain needs time on its own, to do more 
processing. If you put in something new during that 
processing time, some of what you just learned will 
be lost. 


(D Talk about it. Out loud. 

Speaking activates a different part of the brain. If 
you’re trying to understand something, or increase 
your chance of remembering it later, say it out loud. 
Better still, try to explain it out loud to someone else. 
You’ll learn more quickly, and you might uncover 
ideas you hadn’t known were there when you were 
reading about it. 


Write a lot of code! 

There’s only one way to learn to program in G: 
write a lot of code. And that’s what you’re going 
to do throughout this book. Coding is a skill, and 
the only way to get good at it is to practice. We’re 
going to give you a lot of practice: every chapter has 
exercises that pose a problem for you to solve. Don’t 
just skip over them — a lot of the learning happens 
when you solve the exercises. We included a solution 
to each exercise — don’t be afraid to peek at the 
solution if you get stuck! (It’s easy to get snagged 
on something small.) But try to solve the problem 
before you look at the solution. And definitely get it 
working before you move on to the next part of the 
book. 
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Read me 


This is a learning experience, not a reference book. We deliberately stripped out everything 
that might get in the way of learning whatever it is we’re working on at that point in the 
book. And the first time through, you need to begin at the beginning, because the book 
makes assumptions about what you’ve already seen and learned. 


We assume you’re new to C, but not to programming. 

We assume that you’ve already done some programming. Not a lot, but we’ll assume you’ve 
already seen things like loops and variables in some other language, like JavaScript. G is 
actually a pretty advanced language, so if you’ve never done any programming at all, then 
you might want to read some other book before you start on this one. We’d suggest starting 
with Head First Programming. 


You need to install a C compiler on your computer. 

Throughout the book, we’ll be using the Gnu Compiler Collection (gcc) because it’s free 
and, well, we think it’s just a pretty darned good compiler. You’ll need to make sure you 
have gcc installed on your machine. The good news is, if you have a Linux computer, 
then you should already have gcc. If you’re using a Mac, you’ll need to install the 
Xcode/Developer tools. You can either download these from the Apple App Store or by 
downloading them from Apple. If you’re on a Windows machine, you have a couple 
options. Cygwin {http://www.cygwiri.com) gives you a complete simulation of a UNIX 
environment, including gcc. But if you want to create programs that will work on 
Windows plain-and-simple, then you might want to install the Minimalist GNUfor Windows 
(MingW) from http:/ / www.mingw.org. 

All the code in this book is intended to run across all these operating systems, and we’ve 
tried hard not to write anything that will only work on one type of computer. Occasionally, 
there will be some differences, but we’ll make sure to point those out to you. 


We begin by teaching some basic C concepts, and then we start 
putting C to work for you right away. 

We cover the fundamentals of G in Chapter 1. That way, by the time you make it all 
the way to Chapter 2, you are creating programs that actually do something real, useful, 
and — gulp! — fun. The rest of the book then builds on your G skills, turning you from C 
newbie to coding ninja master in no time. 
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The activities are NOT optional. 


The exercises and activities are not add-ons; they’re part of the core content of the book. 
Some of them are to help with memory, some are for understanding, and some will help 
you apply what you’ve learned. Don } t skip the exercises. 

The redundancy is intentional and important. 

One distinct difference in a Head First book is that we want you to really get it. And we 
want you to finish the book remembering what you’ve learned. Most reference books 
don’t have retention and recall as a goal, but this book is about learning, so you’ll see some 
of the same concepts come up more than once. 


The examples are as lean as possible. 

Our readers tell us that it’s frustrating to wade through 200 lines of an example looking 
for the two lines they need to understand. Most examples in this book are shown within 
the smallest possible context, so that the part you’re trying to learn is clear and simple. 
Don’t expect all of the examples to be robust, or even complete — they are written 
specifically for learning, and aren’t always fully functional. 

The Brain Power exercises don’t have answers. 


For some of them, there is no right answer, and for others, part of the learning 
experience of the Brain Power activities is for you to decide if and when your answers 
are right. In some of the Brain Power exercises, you will find hints to point you in the 
right direction. 


the review team 


The technical review team 



V\y\tt /Wilw 



Technical reviewers: 


Dave Kitabjian has two degrees in electrical and computer engineering and about 20 years of experience consulting, 
integrating, architecting, and building information system solutions for clients from Fortune 500 firms to high-tech startups. 
Outside of work, Dave likes to play guitar and piano and spend time with his wife and three kids. 

Vince Milner has been developing in G (and many other languages) on a wide variety of platforms for over 20 years. 
When not studying for his master’s degree in mathematics, he can be found being beaten at board games by six-year-olds 
and failing to move house. 
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1 getting stcirted Witfc C 



Want to get inside the computer’s head? 

Need to write high-performance code for a new game? Program an Arduino? Or use 
that advanced third-party library in your iPhone app? If so, then C’s here to help. C 
works at a much lower level than most other languages, so understanding C gives you a 
much better idea of what’s really going on. C can even help you better understand other 
languages as well. So dive in and grab your compiler, and you’ll soon get started in no time. 


this is a new chapter 





how c works 


C is a language for small fast programs 

The G language is designed to create small, fast programs. It’s 
lower-level than most other languages; that means it creates code 
that’s a lot closer to what machines really understand. 


The way C works 


Computers really only understand one language: machine code, a 
binary stream of Is and Os. You convert your G code into machine 
code with the aid of a compiler. 



File Edit Window Help Compile 


> gcc rocks.c -o rocks 

> 


卜 Wmdov/s, tWis Will 
be tailed rotVs ^t 
mstcad rotVs. 



rocks 



Source 

You start off by 
creating a source 
file. The source file 
contains human- 
readable G code. 


Compile 

You run your source 
code through a compiler. 
The compiler checks 
for errors, and once it’s 
happy, it compiles the 
source code. 


Output 

The compiler creates a new 
file called an executable. This 
file contains machine code, 
a stream of Is and Os that 
the computer understands. 
And that’s the program you 
can run. 


C is used where speed, space, and 
portability are important. Most 
operating systems are written in C. 
Most other computer languages are 
also written in C. And most game 
software is written in C. 


There are three C standards that you may 
stumble across. ANSI C is from the late 1980s 
and is used for the oldest code. A lot of things 
were fixed up in the C99 standard from 1999. And 
some cool new language features were added in 
the current standard, C11, released in 2011 _ The 
differences between the different versions aren’t 
huge, and we’ll point them out along the way. 


2 Chapter 1 






getting started with c 


: 皆考 rpen your pencil 


Try to guess what each of these code fragments does. 


Pcsdv-ibc you i\\\Yk i\\t codt dots. 


int card—count = 11; 
if (card—count > 10) 

puts ("The deck is hot. Increase bet. 


)； 


int c = 10; 
while (c > 0) { 

puts ( n 工 must not write code in class"); 
c = c - 1 ; 


/* Assume name shorter than 20 chars. */ 
char ex [20]; 

puts("Enter boyfriend's name : "); 
scanf ("%19s", ex); 

printf("Dear %s.\n\n\tYou 1 re history•\n", ex); 


char suit = 'H *; 
switch(suit) { 
case 'C': 

puts("Clubs"); 
break; 
case 'D': 

puts ("Diamonds ，，）； 
break; 
case 'H': 

puts("Hearts M ); 
break; 
default : 

puts ("Spades ’，）； 
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fragments demystified 


parpen your pencil 

Solution 


Don’t worry if you don’t understand all of this yet. Everything is 
explained in greater detail later in the book. 


int card—count = 11; b 瓜 1S a w h 0 | c a .^. 1^3 ^.. vav， ) a . b ! c . By } A .. s ^.^°.!!： 

if (card count > 10) )?. :?. !Pr. 

puts ("The deck is hot. Increase bet. ") ； if so； dismay d message. oy\ the .今? W. 和 4. 

This dis^ldys 3 s*tv*m5 oy\ *tV>C dommair>d pvomf 七 ov *tcvmmal- 

int c = 10; ^ blolk > sta+ S Bv\ !^. !P.\ 

while (c > 0) { Cmcht^ I。％ as value is positive... 

puts( n I must not write code in class") 7\ ...dispjay a message... 

c = c - i; :v ar»d dc^|rcasc /the dou^-t. 

} d __ _ —- -- TT^is is -the cr\d of *thc Code should be 'ircpCcj'tcdi- 


/* Assume name shorter than 20 chars. */ 
char ex [20]; 

puts ( "Enter boyfriend' s name : ，'）； 

scanfr%19s'-, ex); ^ 

usev types *mto tnc av-vay- 

printf("Dear %s.\n\n\tYou're history.\n n , ex); 


This will i h scirt ~~ 

^hairadeirs h ei re ih o*P the %s. 


char suit = 
switch(suit) 
case 'C': 


H 


A swi-t^h s ^ CmCh £ 如也 a sihO 
variable -fov- di-f-fcvch-t values. 


puts("Clubs"); 
break; 
case 'D': 

puts("Diamonds"); 
break; 
case 'H': 

puts("Hearts"); 
break; 
default : 

puts("Spades M ); 


This is d 

Cv-ca*tc by\ av-v-ay ZO dhav-a^-tev-s. 

Display a message oy\ -the sd\rcc^. 

S*tov-c wha*t *t^c usev- c^*tc\rs *m*to -the av-vay- 
Display a message mdudii^ -the c^*tc\rcd- 


Cv-ca*tc a dhav-a^-tev variable； s-tov-c -the letter ft. 
Look a 七 value o-f -the vaviable. 

:|s::i 硬：: 

l-f so, display *tiic wov-d w Clubs.” 

Thci^ skip pas*t *tiic o*thc\r dhcdks. 

Is it 令 : T 

l-f so, display -the wov-d w Diamo 的 ds. w 
Thci^ skip pas*t "the o*thc\r dhcdks. 

Js:: 祝 

l-f so, display -the wov-d w Hea\rts ” 

Thci^ skip pas*t o*thc\r dhcdks. 

0*thcv-wisc... 

Display -the wov-d w Spadcs. w 

This is end of *thc *tcs*ts. 
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getting started with c 


Put what does a complete C program look like? 

To create a full program, you need to enter your code into a 
C source file. G source files can be created by any text editor, 

and their filenames usually end with .c. 欠 TWis .is jus*t a do^vc^*t'ior>, bu 七 you should -Pollov/ 'rt- 

Let’s have a look at a typical G source file. 



C programs normally begin with a comment. 

The comment describes the purpose of the code in the file, and might 
include some license or copyright information. There’s no absolute need 
to include a comment here — or anywhere else in the file — but it’s good 
practice and what most G programmers will expect to find. 


The si^iris with / 我 7 


Tiicsc av*c optional- ThcyVc 

ov)\y -theve *to make *rt look 

The Chds with ^ 

❺ Next comes the > 
include section. 

G is a very, very small 
language and it can do 
almost nothing without 
the use of external 
libraries. You will need 
to tell the compiler what 
external code to use by 
including header files 
for the relevant libraries. 

The header you will see 
more than any other 
is stdio.h. The stdio 
library contains code 
that allows you to read 
and write data from and 
to the terminal. 


* Program to calculate the number of cards in the shoe. 

* This code is released under the Vegas Public License. 

* (c)2014 A The College Blackjack Team. 

V 

#include <stdio.h> 

int main() 

{ 

int decks. 

puts("Enter a number of decks"); 
scanf ("%i", &decks); 
if (decks < 1) { 

puts ("That is not a valid number of decks’ 1 ); 
return 1; 

} 

printf ("There are %i cards\n n , (decks * 52)); 
return 0; 


o The last thing you find in a source file are the functions 

All G code runs inside functions. The most important function you will 
find in any G program is called the main () function. The main () 
function is the starting point for all of the code in your program. 


So let’s look at the main() function in a little more detail. 
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mainQ function 



T]ie tnain() fmc^m Up Cl^se 


The computer will start running your program from the main () 
function. The name is important: if you don’t have a function called main (), 
your program won’t be able to start. 

The main () function has a return type of int. So what does this mean? 

Well, when the computer runs your program, it will need to have some way of 
deciding if the program ran successfully or not. It does this by checking the return 
value of the main () function. If you tell your main () function to return 0, this 
means that the program was successful. If you tell it to return any other value, 
this means that there was a problem. 

TW.S \s ^ ^int mairfTP Uchor, tailed Vam ； ^ 1 ' 1 ^ ^ 

should 上 ; ws fee U 心 如 




0 


alv/ays kc 
仏出。 灼. 


l-f wc had a^y they d be ^chtiohcd 


int decks; 


The body o-f the 
-Puhdtioh is always 

su\r\rouhdcd by bv-adcs. 


puts("Enter a number of decks"); 
scanf( n %i n , &decks); 
if (decks < 1) { 

puts("That is not a valid number of decks") 
return 1; 

} 

printf("There are %i cards\n n , (decks * 52)); 
return 0; 


The function name comes after the return type. That’s followed by the function 
parameters if there are any. Finally, we have the function body. The function body 
must be surrounded by braces. 



形 - 

The printf () function is used to display formatted output. It 
replaces format characters with the values of variables, like this: 


The -P*iv-s*t favamcicv y/*ill be mscvtcd heve as a Fi\rs-t wter 

printf("%s says the count is %i n , "Ben", 21); 

广 个 

The second pa\ramc-tcv will be msev-ted heve as m-tegev. Scto^d 


You can include as many parameters as you like when you call the printf () 
function, but make sure you have a matching % format character for each one. 
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C 0c ^ e Magnets 



The College Blackjack Team was working on some code on the dorm fridge, but 
someone mixed up the magnets! Can you reassemble the code from the magnets? 

卜 

* Program to evaluate face values. 

* Released under the Vegas Public License. 


* (c)2014 The College Blackjack Team. 

V 


■ main() 

{ 

char card—name[3]; 

puts("Enter the card—name:"); 

two ^ scanf ( n %2s' card name); 

七。浐 the - 

int val = 0; 

if (card—name[0] == 'K 1 ) { 

val — 10; 

} else if (card—name[0] == 'Q') { 


} else if (card—name[0]== 
val — 10; 



□ 


[^] EU 



(card name[0] 


else 




TV^'is 七 he 


val = atoi (card—name); 七亡乂七 *m*to 3 ir\uwbcv-. 


printf("The card value is: %i\n n , val); 


0; 


「 return I 


:1s, I #include | 

77 ) 
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magnets unmixed 


// 




Code Magnets Solution 


The College Blackjack Team was working on some code on the dorm fridge, but someone 
mixed up the magnets! You were to reassemble the code from the magnets. 


/* 


* Program to evaluate face values. 

* Released under the Vegas Public License. 

* (c)2014 The College Blackjack Team. 

V 



char card—name[3]; 
puts("Enter the card—name: 
scanf ( "%2s n , card—name); 
int val = 0; 

if (card—name[0] — 'K 1 ) { 

val = 10; 

} else if (card name[0]== 


▼ Q ，） 



else if (card—name[0] 
val = 10; 


ED. 



} else { 

val = atoi(card—name); 

} 

printf("The card value is: %i\n n , val) 


0 ; 



tWei^re no 

Dumb Qi] 


Questions 


What does 

card—name [ 0 ] mean? 

It's the first character that 
the user typed. So if he types 10, 
card—name [ 0 ] would be 1. 

Do you always write 
comments using /* and */? 

If your compiler supports the 
C99 standard, then you can begin 
a comment with //. The compiler 
treats the rest of that line as a 
comment. 

How do I know which 
standard my compiler supports? 

Check the documentation for 
your compiler, gcc supports all three 
standards: ANSI C, C99, and C11. 
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getting started with c 


Put how do you ruw the program? 

G is a compiled language. That means the computer will not interpret the code 
directly. Instead, you will need to convert — or compile — the human-readable 
source code into machine-readable machine code. 


To compile the code, you need a program called a compiler. One of the 
most popular G compilers is the GNU Compiler Collection or gcc. gcc is 
available on a lot of operating systems, and it can compile lots of languages 
other than G. Best of all, it’s completely free. 

Here’s how you can compile and run the program using gcc. 



Save the code from the Code Magnets exercise on the 
opposite page in a file called cards.c. 


cards.c 


C souv-tc -files usually cir\d t 



Compile with gcc cards. c -o cards at a command 
prompt or terminal. 


Compile ( 

bo a -f .lc 


tardst 
called ^av-ds. 




cards.c cards 



Run by typing cards on Windows, or ./cards on Mac and 


Linux machines. 


I File Edit Window Help Compile 


> ./cards 

Enter the card name : 




This will be dav-ds.cxc 
i-P you \rc oh l^/ihdows. 



6 ee| B!t^ - 

You can compile and run your code on most machines using this trick: 

心的 — su^svpul, do ihis... w 

gcc zork. c -o zork && . /zork ^ or\ a Wmdioy/s 

This command will run the new program only if it compiles 
successfully. If there’s a problem with the compile, it will skip running 
the program and simply display the errors on the screen. 



fills! 


You should create the 
cards.c file and compile 
it now. We’ll be working 
on it more and more as 
the chapter progresses. 


you are here ► 


9 














test drive 



Tqst DriVQ 


Let’s see if the program compiles and runs. Open up a command prompt 
or terminal on your machine and try it out. 

This li h(! -the todt a^d 

匕浐 ca CS the 匕 av-ds I File Edit Window Help 21 ^ 


TWis Imc rur^s i\\t program. 

|.f youVc ov\ ^/mdoy/s, dor\ *t* 

type / 

-the pv-ojv-arw a^ai^ 

The useir Chtev-S -the 
4on, a WeL 〜 

...a^d f^rojv-am displays^ 

*tV^ dov-\rCspor\d*m5 value 


> gee cards.c 一 o cards 

> ./cards 

Enter the card_name : 

Q 一 

The card value is: 10 

> ./cards 

Enter the card_name : 

A 一 

The card value is: 11 

> ./cards 

Enter the card_name : 

7 一 

The card value is: 7 


R ㈣ 如 • 孙 6o , wW 

4 私 a W 
-to see V\o>w)- 


The program works! 

Congratulations! You have compiled and run a G program. The gcc 
compiler took the human-readable source code from cards.c and converted 
it into computer-readable machine code in the cards program. If you are 
using a Mac or Linux machine, the compiler will have created the machine 
code in a file called cards. But on Windows, all programs need to have a 
•exe extension, so the file will be called cards.exe. 


tJiereicire no 

Dumb Qi] 


Questions 


Why do I have to prefix the program with . / when I run it on Linux and the Mac? 

On Unix-style operating systems, programs are run only if you specify the directory where 
they live or if their directory is listed in the PATH environment variable. 
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Wait, I doiVt get it. When 
we ask the user what the name 
of the card is, were using an 
array of characters. An array of 
characters???? Why? Can’t we use 
a string or something??? 


The C language doesn’t support strings out 
of the box. 

G is more low-level than most other languages, so instead 
of strings, it normally uses something similar: an array of 
single characters. If you’ve programmed in other languages, 
you’ve probably met an array before. An array is just a list of 
things given a single name. So card—name is just a variable 
name you use to refer to the list of characters entered at 
the command prompt. You defined card_name to be a 
two-character array^ so you can refer to the first and second 
character as char_name [ 0 ] and char—name [ 1 ]. To see 
how this works, let’s take a deeper dive into the computer’s 
memory and see how G handles text". 


But ave 
a o^f 


|'»Wav'»cs 七 


do 70U 

s 七呼 . 
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string theory 



Strings Vay Up Ckse - 

Strings are just character arrays. When G sees a string like this: 

s = "Shatner" 


it reads it like it was just an array of separate characters: 




ins is \\o>n you dc-f mc 3^ 3V"vay ^ C- 


s 


， S ，， ， h ，， ， a ，， ， t 


，， ' n ，， ' e ', ' r ' 


Each of the characters in the string is just an element in an array, which is 
why you can refer to the individual characters in the string by using an index, 
like s [ 0 ] and s [ 1 ]. 


^ ^ 


Pow't fall off the end of the string 

But what happens when G wants to read the contents of the string? Say 
it wants to print it out. Now, in a lot of languages, the computer keeps 
pretty close track of the size of an array, but G is more low-level than most 
languages and can’t always work out exactly how long an array is. If G is going 
to display a string on the screen, it needs to know when it gets to the end of 
the character array. And it does this by adding a sentinel character. 

The sentinel character is an additional character at the end of the string that 
has the value \ 0. Whenever the computer needs to read the contents of the 
string, it goes through the elements of the character array one at a time, until 
it reaches \ 0. That means that when the computer sees this: 



C k\r\OY/S 
bo s*bof 
i*t 

sees \0. 


s = "Shatner" 


it actually stores it in memory like this: 

囵固 s 

^ 

That’s why in our code we had to define the card_name variable like this: 

char card name[3]; 


t ||n||e||r ||\0 

^ ^ 


!^\0 is ASCII 

value 0. 

C Coders (tall this 
the NULL 


The card—name string is only ever going to record one or two characters, but because 
strings end in a sentinel character we have to allow for an extra character in the array. 
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t^eretare no o 

Dumb Questi9ns 


Why are the characters numbered 
from 0? Why not 1? 

The index is an offset: it’s a measure 
of how far the character is from the first 
character. 

Why? 

The computer will store the 
characters in consecutive bytes of memory. 
It can use the index to calculate the 
location of the character. If it knows that 
c [ 0 ] is at memory location 1,000,000, 
then it can quickly calculate that c [ 96] 
is at 1,000,000 + 96. 

Why does it need a sentinel 
character? Doesn’t it know how long the 
string is? 

Usually, it doesn’t. C is not very good 
at keeping track of how long arrays are, 
and a string is just an array. 


It doesn’t know how long arrays 
are??? 

No. Sometimes the compiler 
can work out the length of an array by 
analyzing the code, but usually C relies on 
you to keep track of your arrays. 

Does it matter if I use single 
quotes or double quotes? 

Yes. Single quotes are used for 
individual characters, but double quotes 
are always used for strings. 

So should I define my strings 
using quotes (") or as explicit arrays of 
characters? 

Usually you will define strings using 
quotes. They are called string literals, and 
they are easier to type. 



Palnjess Operations 


Not all equals signs are equal. 


In C, the equals sign (=) is 
used for assignment. But a 
double equals sign (==) is 
used for testing equality. 


If you want to increase 
or decrease a variable, 
then you can save space 
with the += and -= 
assignments. 


value 

午 . 


teeth 



^Adds 2 - -to 
teeth += 2; 


teeth == 4 ; 

个 teeth -= 2; 

Tcs*t ^as 个 

-tiic value away Z tcctli. 


Are there any differences between 
string literals and character arrays? 

Only one: string literals are constant. 

What does that mean? 

It means that you can’t change the 
individual characters once they are created. 

What will happen if I try? 

It depends on the compiler, but gcc 
will usually display a bus error. 

A bus error? What the heck’s a 
bus error? 

C will store string literals in memory 
in a different way. A bus error just means 
that your program can’t update that piece 
of memory. 


Finally, if you want to 
increase or decrease a 
variable by 1, use ++ 
and 

teeth++; ^ - |^v-casc by I- 
teeth ; 走 一 〜 by I. 
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do something 


Two types of command 

So far, every command you’ve seen has fallen into one of the following two 
categories. 

|o something 

Most of the commands in G are statements. Simple statements are actions; 
they do things and they tell us things. You’ve met statements that define 
variables, read input from the keyboard, or display data to the screen. 

split_hand() ; TW»s is a simfle 

Sometimes you group statements together to create block statements. Block 
statements are groups of commands surrounded by braces. 


These -fovm 


尸 


a blodk 

because -they av-c 
su\rv-ouir\dcd by bv-a^cs. 






deal—first—card (); 
deal 一 second_card(); 
cards in hand = 2; 


l?o something oijyif something is true 

Control statements such as if check a condition before running the code: 


if (value 一 of 一 hand <= 16 ) is demditiem. 

hit () ; Ruh this statcmchl i-P the dohditioh is tvuc. 

else 

stand () ; Rur\ tWis i*f 6o”d’rbcm is -false. 


if statements typically need to do more than one thing when a 
condition is true, so they are often used with block statements: 


if (dealer—card 

double down 


6 ) { 


hit () ; ^_ 


dOTW these ^orMmahds will 

<ruh i-P the dohditioh is tv-uc. 

丁 he grouped 

… side 3 single blod< s-tatcmch-t. 



I Do you need braces? | 

— 三 

― 三 

― 三 

Block statements allow you to 
treat a whole set of statements as if 
they were a single statement. In C, 
the if condition works like this: 

E § 

— = 

― E 

― = 

― E 

if (countdown == 0) 

― 三 

do—this 一 thing (〉； 

― 三 

― 三 

― 三 

― 三 

The if condition runs a single 

— 三 

statement. So what if you 
want to run several statements 

— E 

in an if? If you wrap a list of 
statements in braces, C will treat 
them as though they were just 
one statement: | 

― 三 

― 三 

― 三 

I if (x == 2) { I 

― E 

call whitehouse(); 

— 三 

I sell oil() ; 1 

― 三 

I x = 0; I 

― 三 

1 } I 

― = 

1 i 

1 I 

1 圍 

— E 

C coders like to keep their code 
short and snappy, so most will 
omit braces on if conditions 

― 三 

and while loops. So instead of 
I writing: ) 

― 三 

1 i 

1 圍 

I if (x == 2) { I 

― 三 

― 三 

puts("Do something"); 

E 2 

I } l 

― = 

― 三 

― 三 

― 三 

most C programmers write: 

1 i 

1 i 

1 I 

if (x == 2) 

― 三 

— 三 

puts( M Do something"); 
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getting started with c 


Here's the code so far 


卜 





* Program to 

evaluate face 

values. 


* Released under the Vegas 

Public 

License. 

* (c)2014 The 

College Blackjack Team. 

V 





#include <stdio.h> 




#include <stdlib.h> 




int main() 

f 





i 

char card 

name [3] ; 




puts("Enter the card name : 

") ； 


scanf( n %2s 

card name); 




int val — 

0; 




if (card name[0] == 'K ! ) 

{ 



val — 

10; 




} else if 

(card name[0] 


'Q') 


val — 

10; 




} else if 

(card name[0] 


'J') 


val — 

10; 




} else if 

(card name[0] 


'A') 

( J 

val — 

11; 



{ 

} else { 




r 

val — 

atoi (card name); 



printf("The card value is: 

%i\n 


return 0; 

} 




j 


IVe had a thought. 
Could this check if 
a card value is in a 
particular range? That 
might be handy... 


O 


o 







page goal header 


Hey, How’s it going? You look 
to me like a smart guy. Audi 
know,，cause I’m a smart guy 
too! Listen, Tm onto a sure 
thing here, and I’m a nice 

guy, so rm going to let you 
monit. See, Tm an expert 
in card counting. The Capo 
di tutti capi. Wtiafs card 
counting, you say? Well, to 
me, it’s a career! 

Seriously, card counting is 
a way of improving ttie odds 
wtien you play blackjack. In 
blackjack, if there are plenty 
of tLigti-value cards left in. 
the shoe, then ttie odds are 
slanted in favor of the player. 
That’s you I 

Card counting helps you 
keep track of ttie numtier o 
tiigtL-value cards left. Say 
you start wittia count of 0. 


Ttien ttie dealer leads with 
a Queen-ttiaf s a tiigti card. 
That，s one less available in. 
the deck, so you reduce ttie 
count by one ： 


It，s a queen ^ count 

But if it’s a low card, like a 4, 
ttie count goes up t»y one ： 


It，s a four ^ count + 1 


Higti cards are 10 s and the 
face cards (Jack, Queen, 
King). Low cards are 3s, 4s, 

5s, and 6s. 

You keep doing this for every 
low card and every higli 
card until ttie count gets real 
tLigti, ttien you lay on cash 


in your next bet and ba-da- 
hingi Soon you’ll have more 

money ttianmyttilrdwlfel 

If you’d like to learn more, 
ttien enroll today in my 

Blackjack Correspondence 

School. Learn more about 
card counting as well as ： 

* Howto use tlie Kelly 
Criterion to maximize ttie 
value of your bet 

* Howto avoid getting 

whacked by a pit boss 

* How to get cannoli stains 
off a silk suit 

* Tilings to wear with plaid 

For more Informatioii, 
contact Cousin Vinny c/o ttie 

Blackjack Correspondence 

School. 


16 Chapter 1 


getting started with c 


Card counting? Iw C? 

Card counting is a way to increase your chances of winning at blackjack. 
By keeping a running count as the cards are dealt, a player can work out 
the best time to place large bets and the best time to place small bets. Even 
though it’s a powerful technique, it’s really quite simple. 


already got 

that docs this 


\us*b 


Wic \ust 3 
variable 


got io dhcdk -fov- a ^ 
values hcv-c...ov- do wc? 



rto>w do 七七 

\i *,s >=1 i ar^A <- ^ 

Is Uto ^Ctks? 


How difficult would this be to write in G? You’ve looked at 
how to make a single test, but the card-counting algorithm 
needs to check multiple conditions: you need to check that 
a number is >= 3 as well as checking that it’s <= 6. 


You need a set of operations that will allow 
you to combine conditions together. 
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what condition the condition is in 


There's more to booleans thaw equals... 

So far, you’ve looked at if statements that check if a single condition is true, but 
what if you want to check several conditions? Or check if a single condition is 
not true? 

备备 checks if two conditions arc true 

The and operator (& &) evaluates to true, only if both conditions given to it are 
true. 

if ((dealer— up—card == 6) && (hand == 11)) 

double—down(); 

The and operator is efficient: if the first condition is false, then the computer 
won’t bother evaluating the second condition. It knows that if the first condition 
is false, then the whole condition must be false. 


Bo*th o-f doy>d"i*tio^s ir>ccd *to be 
-tvuc -fov 七 his picdc o( todt *to 


II checks if owe of two conditions is true 

The or operator (| |) evaluates to true, if either condition given to 
it is true. 

if (cupcakes 一 in—fridge | | chips 一 on—table) 

eat _f ood () ; H w . 

If the first condition is true, the computer won’t bother evaluating 
the second condition. It knows that if the first condition is true, the 
whole condition must be true. 


! flips the value of a condition 

! is the not operator. It reverses the value of a condition. 

if (! brad_on_^phone) 

I \o 七 ’’ answer_phone(); 



Gee} Bits 

In C, boolean values 


are represented by 
numbers. To C, the number 0 is 
the value for false. But what’s the 


value for true? Anything that is 
not equal to 0 is treated as true. 
So there is nothing wrong in 
writing C code like this: 


int people_moshing = 34; 
if (people_moshing) 

take_off_glasses(); 


In fact, C programs often use this 
as a shorthand way of checking if 
something is not 0. 
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Ex^f(ciSe 


You are going to modify the program so that it can be used for card counting. It will need to 
display one message if the value of the card is from 3 to 6. It will need to display a different 
message if the card is a 10, Jack, Queen, or King. 

int main() 

{ 

char card—name[3]; 

puts("Enter the card—name:"); 

scanf ("%2s’' ， card—name); 

int val = 0; 

if (card—name[0] — 1 K 1 ) { 

val —. 10; 

} else if (card—name[0] == 'Q') { 

val — 10; 

} else if (card—name[0] == 'J') { 

val = 10; 

} else if (card—name[0] == 'A 1 ) { 

val —— 11; 

} else { 

val = atoi(card—name); 

} 

/* Check if the value is 3 to 


女 


if 


puts("Count has gone up"); 

/* Otherwise check if the card was 10, J, Q, or K * 
else if 

puts("Count has gone down"); 
return 0; 




The ANSI C standard has no value for true 
and false. C programs treat the value 0 as 
false, and any other value as true. The C99 
standard does allow you to use the words true 
and false in your programs — but the compiler 
treats them as the values 1 and 0 anyway. 
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cards counted 



You were to modify the program so that it can be used for card counting. It needed to display 
one message if the value of the card is from 3 to 6. It needed to display a different message if 
the card is a 10, Jack, Queen, or King. 


int main() 

{ 

char card—name[3]; 

puts ( "Enter the card—name : ’，）； 

scanf ("%2s", card—name); 

int val = 0; 

if (card—name[0] == 'K') { 

val = 10; 

} else if (card—name[0] == * Q') 
val = 10; 

} else if (card—name[0] == 'J 1 ) 
val = 10; 

} else if (card—name[0] == 'A 1 ) 
val = 11; 


else 

val 


atoi(card name); 


Thcirc a\re a -Pew } 

ways o-p y/v-i-t'mg 

"this ^ohditioh. i J 


Check if the value is 3 to 

((val > Z) “（val < 7)) 


'k 


70U 邛 。七 -bV^a-b 7<>u 

wst needed a s—c 
-fov *tw»s? 


puts("Count has gone up"); 

/* Otherwise check if the card was 10, J, Q, or K */ 
else i £ (val ==；==■ \0) 

puts("Count has gone down"); 
return 0; 



Dumb Quest! 


9 ns 


Why not just | and &? 


You can use & and | if you want. 
The & and | operators will always 
evaluate both conditions, but && and 
can often skip the second condition. 


So why do the & and | operators 

exist? 

Because they do more than simply 
evaluate logical conditions. They perform 
bitwise operations on the individual bits of 
a number. 


Huh? What do you mean? 

Well, 6 & 4 is equal to 4, because 
if you checked which binary digits are 
common to 6 (110 in binary) and 4 (100 in 
binary, you get 4 (100). 
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Tqst DriVq 


Let’s see what happens when you compile and run the program now: 


丁 "his lihC 匕 Orhpj ,。 I File Edit Window Help FiveOfSpades 

ih c toAt ^ 


IVlc v-u^ i*t a 
-fcv/ times *bo 

value 

va^ges wovk. 


5 


> gcc cards.c -o cards && ./cards 
Enter the card_name : 

Q 一 

Count has gone down 

> ./cards 

Enter the card_name : 

8 一 

> ./cards 

Enter the card_name : 

3 一 

Count has gone up 


The code works. By combining multiple conditions with a boolean 
operator, you check for a range of values rather than a single value. 
You now have the basic structure in place for a card counter. 



The computer says the 
card was low. The count 
went up! Raise the bet! 
Raise the bet! 


S"tc3l*t^Y dcVifi-C 


you are here 











interview with gcc 



The Compte "BpifottA 


This week’s interview: 

What Has gcc Ever Done for Us? 


Head First： May I begin by thanking you, gcc, for 
finding time in your very busy schedule to speak to 
us. 

gcc ： That’s not a problem, my friend. A pleasure to 
help. 

Head First： gcc, you can speak many languages, is 
that true? 

gcc ： i am fluent in over six million forms of 
communication... 

Head First: Really? 

gcc ： Just teasing. But I do speak many languages. G, 
obviously, but also C++ and Objective-G. I can get 
by in Pascal, Fortran, PL/I, and so forth. Oh, and I 
have a smattering of Go... 

Head First： And on the hardware side, you can 
produce machine code for many, many platforms? 

gcc ： Virtually any processor. Generally, when a 
hardware engineer creates a new type of processor, 
one of the first things she wants to do is get some 
form of me running on it. 

Head First： How have you achieved such incredible 
flexibility? 

gcc: My secret, I suppose, is that there are two sides 
to my personality. I have a frontend, a part of me 
that understands some type of source code. 

Head First： Written in a language such as G? 

gcc ： Exactly. My frontend can convert that language 
into an intermediate code. All of my language 
frontends produce the same sort of code. 


Head First： You say there are two sides to your 
personality? 

gcc ： I also have a backend: a system for converting 
that intermediate code into machine code that is 
understandable on many platforms. Add to that my 
knowledge of the particular executable file formats 
for just about every operating system you’ve ever 
heard of". 

Head First： And yet, you are often described as a 
mere translator. Do you think that’s fair? Surely that’s 
not all you are. 

gcc: Well, of course I do a little more than simple 
translation. For example, I can often spot errors in 
code. 

Head First: Such as? 

gcc: Well, I can check obvious things such as 
misspelled variable names. But I also look for subtler 
things, such as the redefinition of variables. Or I 
can warn the programmer if he chooses to name 
variables after existing functions and so on. 

Head First： So you check code quality as well, 
then? 

gcc ： Oh, yes. And not just quality, but also 
performance. If I discover a section of code inside 
a loop that could work equally well outside a loop, I 
can very quietly move it. 

Head First： You do rather a lot! 

gcc ： I like to think I do. But in a quiet way. 

Head First： gcc, thank you. 
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BE . 

EacK oftiie C files on tiiis pa^e 
represents a complete source file. Your 
job is to play compiler and determine 

Metier each of these files 
will compile, and if not, 
not. For extra bonus 
points, say ^viiatyou tiling 

tire output of each compiled 
file will be wien run, and ^retire! 9 you 
tiiink tire code is worl^in^ as intended. 


A 

^include <stdio.h> 

int main() 

{ 

int card = 1; 
if (card > 1) 

card = card - 1; 
if (card < 7) 

puts ("Small card ，'）； 

else { 

puts("Ace !")； 

} 

return 0; 


B 

^include <stdio.h> 

int main() 

{ 

int card = 1; 
if (card > 1) { 

card = card - 1; 
if (card < 7) 

puts("Small card"); 

else 

puts("Ace !")； 

} 

return 0; 


C 

#include <stdio.h> 

int main() 

{ 

int card = 1; 
if (card > 1) { 

card = card - 1; 
if (card < 7) 

puts("Small card"); 

} else 

puts("Ace !")； 
return 0; 


D 

^include <stdio.h> 

int main() 

{ 

int card = 1; 
if (card > 1) { 

card = card - 1; 
if (card < 7) 

puts("Small card"); 

else 

puts("Ace !")； 
return 0; 


you are here ► 
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code compiled 



BE th^ C^tri^llei §©]ug©ti 

EacK oftiie C files on tiiis pa^e 
represents a complete source file. Your 
job is to play compiler and determine 

A^ieflier each of these files 
will compile, and if not, 
not. For extra bonus 
points, say you tiling 
tire output of each compiled 
file will be wien run, and ^retire! 9 you 
tiiink tire code is worl^in^ as intended. 


The todt Compiles. The 
pvogram displays u Small 
davd.” Bu*t i*t doesn't work 
properly because the else is 

attached *bo *the i*f. 

card = card - 1; 
if (card < 7) 

puts("Small card"); 

else { 

puts("Ace !")； 

} 

return 0; 


A 

^include <stdio.h> 

int main() 

{ 

int card = 1; 
if (card > 1) 


B 

^include <stdio.h> 

int main() 

{ 

int card = 1; 
if (card > 1) 


card 


The Code Compiles. The 
displays 

dhd is ho 七 really y/o\rkir\^ 
properly because the else is 
ma*tdhcd *bo *thc y/\ro^^ i-f. 


card - 


if (card < 7) 

puts("Small card"); 

else 

puts("Ace!"); 


return 0; 


C 

#include <stdio.h> 

int main() 

{ 

int card = 1; 
if (card > 1) { 

card = card - 1; 
if (card < 7) 

puts("Small card"); 

} else 

puts("Ace !")； 

return 0; The CoAt dor^pilcs. The 
} program displays 

dhd is pvopcrly w\ri*t*tch. 

D 

^include <stdio.h> 

int main() 

{ 

int card = 1; 
if (card > 1) { 

card = card - 1; 
if (card < 7) 

puts("Small card"); 

else 

puts("Ace !")； 
return 0; 

} 

The Codt ^ioy\{, Compile 
because -the brakes are 
ho*t ma*tdhed. 
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Whaf s the code like wow? 


int main() 

{ 

char card_name[3]; 
puts ("Enter the card_name : 
scanf ("%2s", card_name); 
int val = 0; 

if (card_name[0] — 'K') { 

val = 10; 

} else if (card_name[0] 
val = 10; 

} else if (card_name[0] 
val = 10; 

} else if (card_name[0] 
val = 11; 

} else { 

val = atoi(card_name); 

/* Check if the value is 3 to 6 * 
if ((val >2) && (val < 7)) 

puts ("Count has gone up"); 

/* Otherwise check if the card was 10, 
else if (val — 10) 

puts("Count has gone down"); 
return 0; 


▼A*) { 



Hmmm...is there something we can do with 
that sequence of if statements? They re all 
checking the same value, card—name[0], and most 
of them are setting the val variable to 10.1 wonder 
if there's a more efficient way of saying that in C. 


O 0 



C programs often need to check the same value several 
times and then perform very similar pieces of code for 
each case. 

Now, you can just use a sequence of if statements, and that will probably be 
just fine. But G gives you an alternative way of writing this kind of logic. 

C can perform logical tests with the switch statement. 












switch statement 


Pulliwg the or switchcroo 

Sometimes when you’re writing conditional logic, you need to 
check the value of the same variable over and over again. To 
prevent you from having to write lots and lots of if statements, 
the G language gives you another option: the switch statement. 

The switch statement is kind of like an if statement, except it 
can test for multiple values of a single variable.. 


switch(train) { 
case 37 : 

winnings = 


i\^t Vam 二二 幻 , add 弓 0 *to 
釙 d 枉⑼ *to ad. 

winnings + 50; 


brsak• 

’ l-P the = add {jo -the 

case 65: w’nrmmy AND TttE/V also add 10 b> 

puts ( n Jackpot!" )； 仏 e v/nrmmy; skip {o -the c^d- 

winnings = winnings + 80; 

case 12 : 


winnings 

break; 
default: 

winnings 

} 


winnings 


2 |-f *b^C *braiir\ 二二 1j uS *t 

add 10 -to *tV)C y/mn'mjs. 


0 


⑽ ““ 屬“岬 


When the computer hits a switch statement, it checks the value 
it was given, and then looks for a matching case. When it finds 
one, it runs all of the code that follows it until it reaches a break 
statement. The computer keeps going until it is told to 
break out of the switch statement. 




Missing breaks can make 
your code buggy. 

Most C programs have a break 
at the end of each case section 
to make the code easier to 
understand, even at the cost of some efficiency. 


Watch it! 
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: 皆考 rpen your pencil 


Let’s look at that section of your cards program again: 


int val = 

0; 


if (card 

name[0] == * K') { 


val —. 

10; 


} else if 

(card name[0]== 

， Q，) 

val —— 

10; 


} else if 

(card name[0]== 

， J，) 

val = 

10; 


} else if 

(card name[0]—— 

， A ，） 

val — 

11 ； 


} else { 

val — 

atoi(card name); 



Do you think you can rewrite this code using a switch statement? Write your answer below: 


you are here ► 
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： ^|l^rpen your pencil 


You were to rewrite the code using a switch statement. 


int val = 

0; 


val - 0] 

if (card 

name[0] — * K *) { 



val — 

10; 


dase 

} else if 

(card name[0] == 

▼Q ，） 

I dasc 4 ’： 

val — 

10; 


dase l vJ ’： 

} else if 

(card name[0 ] — 

， J ， ） 

{ val - 10; 

val = 

10; 


break ； 

} else if 

(card name[0 ]== 

'A') 

{ cast K A t： 

val — 

11 ； 


val - II; 

} else { 

val — 

atoi(card name) ; 


break; 

dc-fault ： 


val ― aW 撕 d ^a^c); 


tWei^re no o 

Dumb Questions 


BULLET POINTS - 

■ switch statements can 
replace a sequence of if 
statements. 

■ switch statements check a 
single value. 

■ The computer will start to run 
the code at the first matching 
case statement. 

■ It will continue to run until it 
reaches a break or gets 
to the end of the switch 
statement. 

■ Check that you’ve included 
breaks in the right places; 
otherwise, your switches will 
be buggy. 


Why would I use a switch 
statement instead of an if? 

If you are performing multiple 
checks on the same variable, you might 
want to use a switch statement. 

What are the advantages of 
using a switch statement? 

There are several. First: clarity. It 
is clear that an entire block of code is 
processing a single variable. That’s not so 
obvious if you just have a sequence of if 
statements. Secondly, you can use fall- 
through logic to reuse sections of code for 
different cases. 


Does the switch statement 
have to check a variable? Can’t it 
check a value? 

Yes, it can. The switch 
statement will simply check that two 
values are equal. 

Can I check strings in a 
switch statement? 

No, you can’t use a switch 
statement to check a string of characters 
or any kind of array. The switch 
statement will only check a single value. 
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Sometimes once is wot enough... 

You’ve learned a lot about the G language, but there are still some 
important things to learn. You’ve seen how to write programs for many 
different situations, but there is one fundamental thing that we haven’t 
really looked at yet. What if you want your program to do something 
again and again and again? 

Using while loops in C 

Loops are a special type of control statement. A control statement 
decides if a section of code will be run, but a loop statement decides 
how many times a piece of code will be run. 

The most basic kind of loop in G is the while loop. A while loop 
runs code over and over and over as long as some condition remains true. 



TV^c W 7 

i\\t Wades. 


^ks ^ohditioh bcW iruhhihg the body. 

while (<some condition 〉） { 
between ... /* Do something here */ 


feodv，you 栋 c Watcs. 


' W\)cv\ \i gets -to ihc cv\d o( ihc body, 七 he dompuiev 
dhcdks i-f -the loop do^di-tio^ is siill -tv-uc. |-P ii is, -the 
body CoAt \ru^s 


Do you do wliile? 

There’s another form of the while loop that 
checks the loop condition after the loop body is 
run. That means the loop always executes at 
least once. It’s called the do. . .while loop: 

do { 

/* Buy lottery ticket */ 

} while(have not won); 



while (more_balls) 

keep—juggling(); 





you are here ► 
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for loops 


Loops often follow the same structure 


You can use the while loop anytime you need to repeat a piece 
of code, but a lot of the time your loops will have the same kind 
of structure: 


o 

o 

o 


Do something simple before the loop, like set a counter. 
Have a simple test condition on the loop. 

Do something at the end of a loop, like update a counter. 


For example, this is a while loop that counts from 1 to 


^~TW\s is loof stav-tuf Code 

This is -the loop 匕 ondi 七 ion. 

printf ("%i green bottles , hanging on a wall\n 
COunter++; 

ik douhtev by ohc. w 


int counter 

TV>is is loof while (counter < 11P { 

update Code 七 ha 七 

>c\ay\s at tv\d 

*tV^c loof body *to 

uf>daie a 6ouy\*tcv-. 


counter); 


Loops like this have code that prepares variables for the loop, 
some sort of condition that is checked each time the loop runs, 
and finally some sort of code at the end of the loop that updates 
a counter or something similar. 

"and the for loop makes this easy 

Because this pattern is so common, the designers of G created the 
for loop to make it a little more concise. Here is that same piece 
of code written with a for loop: 

int counter; 


=1; counter < 11; counter++) { - - 

green bottles, hanging on a wall\n n , counter); \ 

& Because tKcv-e S Imc m ihe loop body, you dould anally have sk.ffed 七 hesc blades. 


TWis 

loop variable. 


/^for ^ counter 


printf("%i 


This is the ic%i dohditioh t^tcktA TL . . , L j ,, 

bcW the loop v-uw cadh time. ^ 1 h,s ,s toAt 




for loops are actually used a lot in G — as much, if not more than, 
while loops. Not only do they make the code slightly shorter, 
but they’re also easier for other G programmers to read, because 
all of the code that controls the loop — the stuff that controls the 
value of the counter variable — is now contained in the for 
statement and is taken out of the loop body. 


Every for loop needs 
to kave sometliing in 
tke tody. 
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You use break to break out... 

You can create loops that check a condition at the beginning or end 
of the loop body. But what if you want to escape from the loop from 
somewhere in the middle? You could always restructure your code, 
but sometimes it’s just simpler skip out of the loop immediately using 
the break statement: 

while(feeling 一 hungry) { 

eat_cake(); 

if (feeling—queasy) { 

/* Break out of the while loop */ 

bv-cak w skips ou*t oi 
loof iw>mcdi3*tclY* 



The break 
statement is 
used to break 

Watch it! ° ut ° f ■oops 

and also 
switch statements. 

: Make sure that you know what 
: you’re breaking out of when 

: you break. 


A break statement will break you straight out of the current 
loop, skipping whatever follows it in the loop body, breaks can 
be useful because they’re sometimes the simplest and best way to 
end a loop. But you might want to avoid using too many, because 
they can also make the code a little harder to read. 


• •• 


and continue to continue 


If you want to skip the rest of the loop body and go back to the 
start of the loop, then the continue statement is your friend: 


while(feeling 一 hungry) { 

if (not_lunch_yet) { 

/* Go back to the loop condition 

continue; takes you b^k 

} "to the sta\rt o-p the loop. 

eat cake(); 



breaks don’t break if 
statements. 


女 


On January 15, 1990, AT&T’s 
long-distance telephone system 
crashed, and 60, 000 people 
lost their phone service. The 
cause? A developer working 
on the C code used in the 
exchanges tried to use a break 
to break out of an if statement 
But breaks don’t break out 
of if s. Instead, the program 
skipped an entire section of 
code and introduced a bug that 
interrupted 70 million phone 
calls over nine hours. 


-tlllllllMIIIIIIIIIIIIIIIIIIIIIIMIIIIIIIIIMIIIIIIIIIIIIIIIIIIIIIIIMIIIIIIIIIIIIIIIIIIIIIMIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIMIIIIIIIIIIMIIIIIIIIIIMIIIIIIIIIIMIIIIIIIIIIMIIIIIIIIIMIIIIIIIIIIIIIIIIIIIIIIMIIIIIIIIIIIIIIIIIIIIIIMIIIIIIIIIIMIIIIIIIIIIMIIIIIIIIIMIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIMINIIIIIlIKT 


you are here ► 
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writing functions 



Vriting Fimeti^ns Up C^se 


Before you try out your new loop mojo, let’s go on a detour and 
take a quick look at functions. 

So far, you’ve had to create one function in every program you’ve 
written, the main () function: ^ .. r 

<TW,s »s oUk 

This -Puh^tioh -^ int main () Noth’，between these folv-Ch-thcscs. 


\rctu\fhS ah 

•nvt value. 

T\\c body 

suvv-ouy\dcd by 
Watcs. 



puts ("Too young to die; too beautiful to live"); 

return 0; f 

W\)tv\ you Yt dov\t, you v-ctuv-h a vdlue. 


T\\t body o*f *t^c 

i\^t part tV^at dots stud 


Pretty much all functions in G follow the same format. For 
example, this is a program with a custom function that gets called 
by main () : 


#include <stdio.h> 


Rctuv-hS dh ih-fc value 

larger(int a, int b) 



if (a > b) 
return a; 
return b; 


TWis WW takes tv/o 士 : 

j a ^d b. BotV) a^r^umcirrb art *mts. 


int main() 

{ 

int greatest 
printf ( f, %i is the greatest! \n n , greatest); 
return 0; 


CallihJ "the hcv*c 

=larger(100, 1000); 



The larger () function is slightly different from main () because 
it takes arguments or parameters. An argument is just a local 
variable that gets its value from the code that calls the function. The 
larger () function takes two arguments — a and b — and then it 
returns the value of whichever one is larger. 


The Polite GuitJe 丄 
Sfan^artfe 

The main () function 
has an int return type, 
so you should include a 
return statement when 
you get to the end. But 
if you leave the return 
statement out, the code 
will still compile — though 
you may get a warning 
from the compiler. A 
C99 compiler will insert 
a return statement for 
you if you forget. Use 
-std=99 to compile to 
the C99 standard. 
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- V^li 姐初 1 s Up Cl^se 

Most functions in G have a return value, but sometimes you 
might want to create a function that has nothing useful to return. It 
might just do stuff rather than calculate stuff. Normally, functions always 
have to contain a return statement, but not if you give your function 
the return type void: 

The void \rc*tu\r^ vo id complain () 

{ 

puts (’ ▼ I'm really not happy"); 

} s w -for d 代 tu 作 

staWA b^ausc »Vs a void WW. 

In G, the keyword void means it doesn’t matter. As soon as you tell 
the G compiler that you don’t care about returning a value from the 
function, you don’t need to have a return statement in your function. 


"type "the 
\rciuv-r> any 七 hi ， 




Dumb Questi9ns 

If I create a void function, 
does that mean it can’t contain a 
return statement? 

You can still include a return 
statement, but the compiler will most 
likely generate a warning. Also, there’s 
no point to including a return 
statement in a void function. 

Really? Why not? 

Because if you try to read the 
value of your void function, the 
compiler will refuse to compile your 
code. 



Chaining 


Almost everything in C has 
a return value, and not just 
function calls. In fact, even 
things like assignments have 
return values. For example, if you look at 
this statement: 


X 


4; 


It assigns the number 4 to a variable. The 
interesting thing is that the expression 
x = 4 ,5 itself has the value that was 
assigned: 4. So why does that matter? 
Because it means you can do cool tricks, 
like chaining assignments together: 


So y\o^i y is also se 七 *to 千 . 
• he 

X 二午 ” has y = (x = 
the value 午 . ^_ 少 


4) 


That line of code will set both x and y to 
the value 4. In fact, you can shorten the 
code slightly by removing the parentheses: 


y 


X 


4; 


You’ll often see chained assignments in 
code that needs to set several variables to 
the same value. 


you are here ► 
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Mixed 

Messages 


A short C program is listed below. One block of the program is missing. Your 
challenge is to match the candidate block of code (on the left) with the output 

that you’d see if the block were inserted. Not all of the lines of output will be 
used, and some of the lines of output might be used more than once. Draw lines 
connecting the candidate blocks of code with their matching command-line output. 



Candidate todc ^ocs 一 . 


Candidates: 
y = x - y; 


Possible output: 
22 46 


with 

OhC o-P the 

possible outputs. 


y = y + x; 

11 34 59 


y = y + 2 ； 
if (y > 4) 

y = y - 1; 


02 14 26 38 


02 14 36 48 

x = x + 1; 


y = y + x; 

00 11 21 32 42 


if 

(y < 

5) { 






11 

21 

32 

42 

53 


x = 

x + 1; 







if 

(y < 3) 








X = x - 1; 

00 

11 

23 

36 

410 

} 







y = 

y + 

2 ; 

02 

14 

25 

36 

47 
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Now that you know how to create while loops, modify the program to keep a running count 
of the card game. Display the count after each card and end the program if the player types X. 
Display an error message if the player types a bad card value like 11 or 24. 


#include <stdio.h> 
#include <stdlib.h> 
int main() 

{ 

char card_name[3]; 
int count = 0; 
while ( 


Y 




puts ( "Enter the card_name : ’▼); 

scanf ( n %2s n , card_name); 

int val = 0; 

switch(card 一 name[0]) { 

case 'K': 

case 'Q': 

case 'J': 

val = 10; 


break; 


case 'A' : 


val = 11; 


break; 
case 'X': 




七 v/ill you do i^cv-c? 


default : 

V^ u -fco display an cv-v-ov- i-f val = atoi (card—name); 

七 he val is ⑽七 m 七 “e / to u.^^ 

lO. should ^Iso skip -the 七 
o( 七 he loop body av\d tvy aja'm. 


if ((val >2) && (val <7))( 

Add I io Couv)i. - ^ count++; 

} else if (val — 10) { 

SuArbratt I - - > count--; 

} 

printf ("Current count : %i\n", count); 

} 

return 0; 


you are here ► 
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Mixed 

Messages 

Solution 


A short C program is listed below. One block of the program is missing. Your 
challenge was to match the candidate block of code (on the left) with the output 

that you’d see if the block were inserted. Not all of the lines of output were used. You 
were to draw lines connecting the candidate blocks of code with their matching 
command-line output. 


^include <stdio.h> 

int main() 

{ 

int x = 0; 
int y = 0; 
while (x < 5) 


return 0; 



printf ("%i%i n , x, y) 
x = x + 1; 


Candidate code 30 


cs 




Candidates: Possible output: 
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Now that you know how to create while loops, you were to modify the program to keep a 
running count of the card game. Display the count after each card and end the program if the 
player types X. Display an error message if the player types a bad card value like 11 or 24. 


#include <stdio.h> 

#include <stdlib.h> 
int main() 

{ 

char card 一 name[3] 
int count = 0; 
while ( ^ 

puts("Enter the card 一 name: 
scanf ("%2s", card—name); 
int val = 0; 
switch(card_name[0]) { 

'K' 




u bo cMcck ^ kst Aarad 七饮心 a 於 ><. 


); 


case 
case 'Q' 
case 'J' 

val = 10 
break; 
case 'A 1 : 


val = 11 
break; 


case 


丁 his is just ohC way o( 
wHfmg this dohditioh. 


t：^ 以二 . 


Weak us out 0 心 loof, because msidc 

， x ，： a statewt. a 30 ba^ ^ 

04 loo ! > . ” 七， a3am . 

default : 

val = atoi(card_name); 

pu*ts( w | do^*t uhdcrsiahd yalucfO; 

dohtmuej 


if ((val >2) && (val < 7)) { 

count++; 

} else if (val — 10) { 

count--; 

} 

printf ("Current count : %i\n", count); 


return 0; 
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test drive 



Tesr DriVq 


Now that the card-counting program is finished, it’s time to take it for 
a spin. What do you think? Will it work? 


T~KlS will £.orv\pi|c | File Edit Window Help GoneLoopy 




ov\ 1/Vmdov/s. 




3hd \ruh tlic 
p\rog\rarh. 


Wic y\o>/ tV^cdk 

i-f i*t looks 

like d Corrtd 
tav*dl value- 



The 匕 ouirt is 


> gcc card_counter.c 一 o card—counter && •/card—counter 
Enter the card_name : 

4 一 
Current count : 1 
Enter the card_name : 

K 一 

Current count : 0 
Enter the card_name : 

3 一 

Current count : 1 
Enter the card_name : 

5 一 
Current count : 2 
Enter the card name: 

23 _ 

I don't understand that value! 

Enter the card_name : 

6 一 
Current count : 3 
Enter the card_name : 

5 一 

Current count : 4 
Enter the card_name : 

3 一 

Current count : 5 
Enter the card_name : 

X 一 


By betting big when 
the count was high, I 


made a fortune! 




O 




The card counting program works! 

You’ve completed your first G program. By using the power of G 
statements, loops, and conditions, you’ve created a fully functioning card 
counter. 


Great job! 



Disdlaimcv -： Usrnj a dompu*tc\r -fo\r dd\rd douirrtmg is ille^dl m s*ta*tcs, 


Bv\d those ddsmo guys da 竹 yt kmdd J^a\rly. So do^*t do i*t ； 


伙？ 


0 
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getting started with c 


iiereiare no 。 

Dumb Questi9ns 


Why do I need to compile C? 
Other languages like JavaScript aren’t 
compiled, are they? 

C is compiled to make the code 
fast. Even though there are languages 
that aren’t compiled, some of those—like 
JavaScript and Python—often use some 
sort of hidden compilation to improve their 
speed. 

Is C++ just another version of C? 

No. C++ was originally designed as 
an extension of C, but now it’s a little more 
than that. C++ and Objective-C were both 
created to use object orientation with C. 


What’s object orientation? Will we 
learn it in this book? 

Object orientation is a technique to 
deal with complexity. We won’t specifically 
look at it in this book. 

C looks a lot like JavaScript, Java, 
C#, etc. 

C has a very compact syntax and it’s 
influenced many other languages. 

What does gcc stand for? 

The Gnu Compiler Collection. 


Why “collection ”？ Is there more 
than one? 

The Gnu Compiler Collection can be 
used to compile many languages, though 
C is probably still the language with which 
it’s used most frequently. 

Can I create a loop that runs 
forever? 

Yes. If the condition on a loop is the 
value 1, then the loop will run forever. 

Is it a good idea to create a loop 
that runs forever? 

Sometimes. An infinite loop (a loop 
that runs forever) is often used in programs 
like network servers that perform one thing 
repeatedly until they are stopped. But most 
coders design loops so that they will stop 
sometime. 


^^BUIIET POINTS - 

■ Awhile loop runs code as long as its 
condition is true. 

■ A do-while loop is similar, but runs the 
code at least once. 

■ The for loop is a more compact way of writing 
certain kinds of loops. 

■ You can exit a loop at any time with break. 

■ You can skip to the loop condition at any time 
with continue. 


The return statement returns a value from 
a function. 

void functions don’t need return 
statements. 

Most expressions in C have values. 

Assignments have values so you can chain 
them together (x = y = 0). 
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c toolbox 



Your C Toolbox 


You’ve got Chapter 1 under 
your belt，and now you’ve 
added C basics to your toolbox. 
For a complete list of tooltips in the 
book, see Appendix ii. 


Jfov 肩 
oJf a v/av.'aWe. 




arc 




3 y\A s * 


Blodk 

3V-C su\r\rouhdcd 
by { ahd } 
Abrades). 


Jfov 

\ x \it \十七 av ^ 

。认七，七 . 


4 

浐 Uh todt i-f 
somctliihj is 

bruc 



>u CBv\ use ff 
3hd || *to dombihC 
dohditiohS 
*toytlic\r. 


<^Ct is -the 
most popular 

C dompilev-. 



V^um soum^ c ^jj c 
^ould have , 
ehdihg 


t oAt as \o^ 
as a 

\S *b-VAC- 


t. 


乙 OVA 於七七七 1 
一飧 aAA 


doiAh 七 — 


mcahs 


subtract 1 


-fv-om douht 



“ loops a\rc a 

wa y ^ wH-tih 
loops. 


do-v/hile 
loops \ruh 

Code a*t 
leas 七 ohde. 
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2 memory and pointers 



and of course, Mommy 
never lets me stay out 
▲ after 6 p.m. 




Thank heavens my 
boyfriend variable Isn't 
in read-only memory. 


What are you ^ 

參 pointing at? 




If you really want to kick butt with C, you need to understand 
how C handles memory. 

The C language gives you a lot more control over how your program uses the computer’s 
memory. In this chapter, you’ll strip back the covers and see exactly what happens when 
you read and write variables. You’ll learn how arrays work, how to avoid some nasty 
memory SNAFUs, and most of all, you’ll see how mastering pointers and memory 
addressing is key to becoming a kick-ass C programmer. 


this is a new chapter 




introducing pointers 


C code includes pointers 


Pointers are one of the most fundamental things to understand in 
the G programming language. So what’s a pointer? A pointer is 
just the address of a piece of data in memory. 

Pointers are used in G for a couple of reasons. 


To test uncterstanct 
pointers, gfo slowly* 


o Instead of passing around a whole copy of the data, you 
can just pass a pointer. 

T\s\s is a 乙 。 n d 

(O 0 


Ive got the 
answer you need; 
ifs right here in 
the Encyclopedia 
Britannica. 



you y\ccd. 


0 


Or you could 
just look at 
page 241. 


丁 Wis is a fom*bcv * ： 
仏 c loda*t'ioy\ o-f 



You might want two pieces of code to work on the same 


piece of data rather than a separate copy. 



Pointers help you do both these things: avoid copies and share data. 
But if pointers are just addresses, why do some people find them 
confusing? Because they’re a form of indirection. If you’re not 
careful, you can quickly get lost chasing pointers through memory. 
The trick to learning how to use G pointers is to go slowly. 


But I prefer 
this one—ifs 
got kittens! 


o 


Don’t try to rush 
this chapter. 

Pointers are a simple 
idea, but you need 
to take your time and understand 
everything. Take frequent breaks, drink 
plenty of water, and if you really get 
stuck, take a nice long bath. 



42 Chapter 2 










memory and pointers 


Pigging into memory 

To understand what pointers are, you’ll need to dig into 
the memory of the computer. 

Every time you declare a variable, the computer creates 
space for it somewhere in memory. If you declare a 
variable inside a function like main (), the computer 
will store it in a section of memory called the stack. If 
a variable is declared outside any function, it will be stored 
in the globals section of memory. 

\/av-\ablc V m 


int y 



二 \fiOOfiOO . —/ 

Value I- 


int main() 

{ 

int x = 4; 




return 0; 


\/aHablc x will live m the siatk 
/Wcmovy addvess ^, 100 , 000 . 

1/alue 午. 


The computer might allocate, say, memory location 
4,100,000 in the stack for the x variable. If you assign 
the number 4 to the variable, the computer will store 4 
at location 4,100,000. 



If you want to find out the memory address of the 
variable, you can use the & operator: 

fx. is -the addv-css o( 

printf("x is stored at %p\n n , &x); 

P 

used *bo kwa 七 addvesscs. 


This is what the 
todt will 

is stored at 0x3E8FA0 , 

a address 


TWis is ^, 100,000 m 

(base I 心 ） fowat 


° h y°^ 


The address of the variable tells you where to find the 
variable in memory. That’s why an address is also called 
a pointer, because it points to the variable in memory. 


GLOBALS 

^ yJives ih globals. 

i 




I 

eODK- 






1 








> 一 

一！ 

■■■ 


匕 



1 

: 

'■ 


A variable declared inside a 
function is usually stored in tke 
stack 

A variable cteclared outside a 
function is stored in glotals* 
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pirates of the bermuda rectangle 

Set sail with pointers 

Imagine you’re writing a game in which players have to 
navigate their way around the … 



The game will need to keep control of lots of things, like 
scores and lives and the current location of the players. You 
won’t want to write the game as one large piece of code; 
instead, you’ll create lots of smaller functions that will each 
do something useful in the game: 



What does any of this have to do with pointers? Let’s begin 
coding without worrying about pointers at all. You’ll just 
use variables as you always have. A major part of the game 
is going to be navigating your ship around the Bermuda 
Rectangle, so let’s dive deeper into what the code will need 
to do in one of the navigation functions. 
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memory and pointers 


Set sail sou'cast Cap'w 


The game will track the location of players using latitudes and 
longitudes. The latitude is how far north or south the player 
is, and the longitude is her position east or west. If a player 
wants to travel southeast, that means her latitude will go down, 
and her longitude will go up: 


So you could write a go_south_east () function that takes 
arguments for the latitude and longitude, which it will then 
increase and decrease: 

m . n ,.,,. 卜 、 pass m *tV\c latrUdc 

ffinclude <stdio. h> , , ■ 

dy\d 

V 

void go south east (int lat, int Ion) 


lat 

Ion 


=lat - 1; ~ the 

n … latitude- 

— Ion + 1 ； 

个 

Increase -the lo^ji-tudc- 



int main() 

{ 

int latitude = 32; 
int longitude = -64; 

go_south_east(latitude, longitude); 

printf("Avast! Now at : [%i, %i]\n n , latitude, longitude); 

return 0; 


The program starts a ship at location [32, -64], so if it 
heads southeast, the ship’s new position will be [31 ， —63]. 
At least it will be if the code works … 



Look at the code carefully. Do you think it will work? Why? Why not? 
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test drive 



Tqst DriVQ 


The code should move the ship southeast from [32, -64] to 
the new location at [31, —63]. But if you compile and run the 
program, this happens: 



^TF? The ship I File Edit Window Help Savvy? 

still ih the 

same pla 匕 e. 


T\\t 


> gcc southeast.c -o southeast 

> ./southeast 

Avast! Now at: [32, -64] 

> 


The ship’s location stays exactly the same as before. 



C sends arguments as values 

The code broke because of the way that G calls functions. 




Initially, the main () function has a local variable called longitude 



copies the value of the longitude variable to the Ion argument. 
This is just an assignment from the longitude variable to the Ion 
variable. When you call a function, you don’t send the variable as an 
argument, just its value. 


TV\\s \s a ^ v 狄 iablc 

to 山 …” a 
七 V>c lov\jrtvA(ic value. 




When the go_south 一 east () function changes the 
value of Ion, the function is just changing its local copy. 
That means when the computer returns to the main () 
function, the longitude variable still has its original 
value of 32. 


But if that’s how G calls functions, how can you ever write a 
function that updates a variable? 

It’s easy if you use pointers... 


Ohly -the Io^l dopy 

—t 



TiiC ovi^mal vaviablc 
keeps i*ts ovi^mal value- 
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memory and pointers 


Try passing a pointer to the variable 

Instead of passing the value of the latitude and longitude 
variables, what happens if you pass their addresses^ If the 
longitude variable lives in the stack memory at location 4,100,000, 
what happens if you pass the location number 4,100,000 as a 
parameter to the go_south_east () function? 


The latitude — 

vav-iablc is at 

lodaiioh 

^,100,000. 



latitude 




32 


^ 4,100 


,000 O 


Please 

upda-te locKer 

〜 00,000 


Instead ?assm^ 
-tV^c value ok *tV^c 
vd\ridbU) pss .rts 
|o6a*t'»ov\. 


If the go_south 一 east () function is told that the latitude 
value lives at location 4,100,000, then it will not only be able to find 
the current latitude value, but it will also be able to change the 
contents of the original latitude variable. All the function needs 
to do is read and update the contents of memory location 4,100,000. 




latitude o 



^4^100,000 o 


Because the go_south_east () function is updating the original 
latitude variable, the computer will be able to print out the 
updated location when it returns to the main () function. 

Pointers make it easier to share memory 

This is one of the main reasons for using pointers — to let functions 
share memory. The data created by one function can be modified by 
another function, so long as it knows where to find it in memory. 

Now that you know the theory of using pointers to fix the 
go_south_east () function, it’s time to look at the details of 
how you do it. 



tWeiare nQ 。 ' 

Dumb Questi9ns 


I printed the location of the 
variable on my machine and it wasn’t 
4,100,000. Did I do something wrong? 

You did nothing wrong. The memory 
location your program uses for the variables 
will be different from machine to machine. 

Why are local variables stored in 
the stack and globals stored somewhere 
else? 

Local and global variables are used 
differently. You will only ever get one copy of 
a global variable, but if you write a function 
that calls itself, you might get very many 
instances of the same local variable. 

What are the other areas of the 
memory used for? 

You’ll see what the other areas are for 
as you go through the rest of the book. 
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memory pointers 


Using memory pointers 


There are three things you need to know in order to use 
pointers to read and write data. 

o Get the address of a variable. 

You’ve already seen that you can find where a variable is stored in 
memory using the & operator: 

The %p -fovrwci-t will 

out the lodaiioh m 

hex (base l^>) -foymai printf ( n x lives at %p\n f, . 


int x 


4; 


But once you’ve got the address of a variable, you may want to store it 
somewhere. To do that, you will need a pointer variable. A pointer 
variable is just a variable that stores a memory address. When you 
declare a pointer variable, you need to say what kind of data is stored 
at the address it will point to: 

This is a poihtc\r variable 



如 address that s-to\rcs av\ mt. 


int * address of x = &x; 


❺ 


Read the contents of an address. 

When you have a memory address, you will want to read the data 
that’s stored there. You do that with the * operator: 


❺ 


int value stored = * address of x;^ - 

The * and & operators are opposites. The & operator takes a piece 
of data and tells you where it’s stored. The * operator takes an 
address and tells you what’s stored there. Because pointers are 
sometimes called references, the * operator is said to dereference 
a pointer. 

Change the contents of an address. 

If you have a pointer variable and you want to change the data 
at the address where the variable’s pointing, you can just use the * 
operator again. But this time you need to use it on the left side of 
an assignment: 


*address of x 


99 


i 



/ 

addv-css o 
vav-iablc ： 

^ , 100,000 


This will \rcad 七 he ai 

"the rwernovy ddd^ess by 
add\rcss__o-r__^. This will be se 七 
"to 午 : ihe value o\rig*mally s-toved 
•m 七 he x variable. 


OK, now that you know how to read and write 
the contents of a memory location, it’s time 
for you to fix the go_south_east() function. 


This will 七 he fioivteivts of 

the o\rijmal X variable "to °\% 
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memory and pointers 



Compass Magnets 


Now you need to fix the go_south_east () function so that it uses 
pointers to update the correct data. Think carefully about what type of 
data you want to pass to the function, and what operators you’ll need 
to use to update the location of the ship. 


#include <stdio.h> 


void go south east( 


l/\^a 七 k'mds v/ill s*tovc 

memovv addv-csscs -fov m*U? 

{ \ 

lat A 


Ion) 




int main() 


int latitude = 32; 
int longitude = -64; 


go south east( 


RcrwCrwbcv*-* you \rc "fco -the 
addv-csscs o-f variables. 

r )； 


printf("Avast! Now at : [%i, %i]\n ", latitude, longitude); 

return 0; 
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compass magnets 



Compass Magnets Solution 

You needed to fix the go_south_east () function so that it 
uses pointers to update the correct data. You were to think carefully 
about what type of data you want to pass to the function, and what 
operators you’ll need to use to update the location of the ship. 


#include <stdio.h> 


void go south east( 


丁 he a\rgurwChts will s-fco\rc foihtcv-s 
so they heed "to be iirt 决 . 



lat, 



Ion) 




EED … 


- 1 


冰 la 七己扣 v-cad old value 

ay>d set ^ valuc * 


I *lon 


int main() 

{ 

int latitude = 32; 
int longitude = -64 


>u v\ccd h> -f md 七 he address 

o-f -the latitude lo^^i-tudc 
vav-iablcs v/iih f 





go_south—east( 
printf("Avast! Now at 
return 0; 



[%i, %i]\n n , latitude, longitude) 
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memory and pointers 



Tqst DriVq 


Now if you compile and run the new version of the function, 
you get this: 


This is 
southeast o( 
the oiri^ihdl 
lod^ioh. 


| File Edit Window Help Savvy? 



> gcc southeast 

> ./southeast 

.c 一 o 

southeast 

Avast! Now at: 

> 

[31, - 

-63] 



The code works. 

Because the function takes pointer arguments, it’s able to 
update the original latitude and longitude variables. 
That means that you now know how to create functions that 
not only return values, but can also update any memory 
locations that are passed to them. 


^^BUILET POINTS — 

■ Variables are allocated storage in 
memory. 

■ Local variables live in the stack. 

■ Global variables live in the globals 
section. 


■ The & operator finds the address of 
a variable. 

■ The * operator can read the contents 
of a memory address. 

■ The * operator can also set the 
contents of a memory address. 


■ Pointers are just variables that store 
memory addresses. 
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no dumb questions 


Are pointers actual address 
locations? Or are they some other kind 
of reference? 

They’re actual numeric addresses in 
the process’s memory. 

What does that mean? 

Each process is given a simplified 
version of memory to make it look like a 
single long sequence of bytes. 

And memory’s not like that? 

It's more complicated in reality. But 
the details are hidden from the process so 
that the operating system can move the 
process around in memory, or unload it and 
reload it somewhere else. 



Is memory not just a long list of 
bytes? 

The computer will probably structure 
its physical memory in a more complex way. 
The machine will typically group memory 
addresses into separate banks of memory 
chips. 

Do I need to understand this? 

For most programs, you don’t need to 
worry about the details of how the machine 
arranges its memory. 

Why do I have to print out pointers 
using the %p format string? 

You don’t have to use the %p string. 
On most modern machines, you can use 
% li— although the compiler may give you 
a warning if you do. 


Why does the %p format display 
the memory address in hex format? 

It's the way engineers typically refer 
to memory addresses. 

If reading the contents of a 
memory location is called dereferencing, 
does that mean that pointers should be 
called references? 

Sometimes coders will call pointers 
references, because they refer to a memory 
location. However, C++ programmers 
usually reserve the word reference for a 
slightly different concept in C++. 

Oh yeah, C++. Are we going to 
look at that? 

No, this book looks at C only. 
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memory and pointers 


How do you pass a string to a fuwctiow? 

You know how to pass simple values as arguments to functions, but what 
if you want to send something more complex to a function, like a string? 
If you remember from the last chapter, strings in G are actually arrays of 
characters. That means if you want to pass a string to a function, you can 
do it like this: 



void fortune cookie (char msg[]) 



Tk -fur^d*tior\ Will be passed 3 Aav 


printf("Message reads : %s\n n , msg); 


char quote[] = "Cookies make you fat"; 
fortune cookie(quote); 


The msg argument is defined like an array, but because you won’t know 
how long the string will be, the msg argument doesn’t include a length. 

That seems straightforward, but there’s something a little strange going on... 

Honey, who shrank the string? 

G has an operator called sizeof that can tell you how many bytes of 
space something takes in memory. You can either call it with a data type or 
with a piece of data: 

^ 你 0 在七 七 his sizeof (int) TKis y/ill vetuvn % y/WiA is 分 

will \rctu\rh the value 午 . sizeof ("Turtles ! ") ^~ - plus *bKc \0 cir\d 


But a strange thing happens if you look at the length of the string 
you’ve passed in the function: 


void fortune_cookie(char msg[]) 

{ 

printf("Message reads : %s\n n , msg); 

printf("msg occupies %i bytes\n ", sizeof(msg)); 


0??? /u ov\ some 
-this 

rwijhi cvcr> say 午 / 
gives? 



File Edit Window Help TakeAByte 


> ./fortune 一 cookie 

Message reads : Cookies make you fat 
msg occupies 8 bytes 

> 


Instead of displaying the full length of the string, the code returns 
just 4 or 8 bytes. What’s happened? Why does it think the string 
we passed in is shorter? 



Why do you think sizeof (msg) 
is shorter than the length of 
the whole string? What is ms g? 
Why would it return different 
sizes on different machines? 
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array variables 


Array variables are like pointers... 

When you create an array, the array variable can be used as a 
pointer to the start of the array in memory. When G sees a line of 
code in a function like this: 


The variable will 


七 he address 
of -the -Pi\rs-t dhav-adiev- 
’m 七 he s-tv-mg. 



"Cookies make you fat"; 



\o 


The computer will set aside space on the stack for each of the 
characters in the string, plus the \0 end character. But it will also 
associate the address of the first character with the quote 
variable. Every time the quote variable is used in the code, the 
computer will substitute it with the address of the first character in 
the string. In fact, the array variable is just like a pointer. 

printf ("The quote string is stored at: %p\n f, , 


You use w <\uo*tc W as 
a pomtev- variable, 

-b^ou^V) iVs 3V"\r3y. 

quote); 


|-f you y/v-»*tc d *tcs*t fv-ojvam 
•to display address, you 
y/'iII see like 七 …. 



File Edit Window Help TakeAByte 


> • /where_is 一 quote 

The quote — string is stored at: 0x7fff69d4bdd7 

> 


so our function was passed a pointer 


That’s why that weird thing happened in the f ortune_cookie () 
code. Even though it looked like you were passing a string to the 


f or tune—cookie () function, you were actually just passing a 

pointer to it: _ 

' 

void fortune cookie(char msg[]) 


is actually a fom-tev- variable, 

ponvts 七 0 -the message- 


printf("Message reads : %s\n n , msg); 

printf("msg occupies %i bytes\n n , sizeof(msg)); 


And that’s why the sizeof operator returned a weird result. It 
was just returning the size of a pointer to a string. On 32-bit 
operating systems, a pointer takes 4 bytes of memory and on 64-bit 
operating systems, a pointer takes 8 bytes. 



s'izjcaf(w\sj) is jus 
S*I2^ a fo'mtcv- 


is \ust 
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memory and pointers 


What the computer thinks whew it rum your code 

O The computer sees the function. 


void fortune cookie(char msg[] 


I 


0 


O 


Hmmm...looks like they intend to pass 
an array to this function. That means 
the function will receive the value of the 
array variable, which will be an address, 
so msg will be a pointer to a char. 


❺ Then it sees the function contents. 


printf("Message reads : %s\n n , msg); 

printf("msg occupies %i bytes\n n , sizeof(msg)) 


I 


o O 


I can print the message because I know 
it starts at location msg. sizeof(msg). 
Thafs a pointer variable, so the answer is 
8 bytes because thafs how much memory 
it takes for me to store a pointer. 


o The computer calls the function. 


char quote[] = "Cookies make you fat 
fortune cookie(quote); 




0 


0 


So quotes an array and Ive got to pass 
the quote variable to fortune—cookie(). 
ril set the msg argument to the address 
where the quote array starts in memory. 
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no dumb questions 


BULLET POINTS — 

■ An array variable can be used as a 
pointer. 

■ The array variable points to the first 
element in the array. 

■ If you declare an array argument 
to a function, it will be treated as a 
pointer. 


■ The sizeof operator returns the 
space taken by a piece of data. 

■ You can also call sizeof for a data 
type, such as sizeof (int). 

■ sizeof (a pointer ) returns 
4 on 32-bit operating systems and 8 
on 64-bit. 



Dumb Quest? 


9ns 


Is sizeof a function? 

No, it's an operator. 

What’s the difference? 

An operator is compiled to a sequence of instructions by 
the compiler. But if the code calls a function, it has to jump to a 
separate piece of code. 

So is sizeof calculated when the program is 
compiled? 

Yes. The compiler can determine the size of the storage at 
compile time. 


If I create a pointer variable, does the pointer variable 
live in memory? 

Yes. A pointer variable is just a variable storing a number. 

So can I find the address of a pointer variable? 

Yes—using the & operator. 

Can I convert a pointer to an ordinary number? 

On most systems, yes. C compilers typically make the long 
data type the same size as a memory address. So if p is a pointer 
and you want to store it in a long variable a, you can type 
a = (long) p. We’ll look at this in a later chapter. 


Why are pointers different sizes on different machines? 

On 32-bit operating systems, a memory address is stored as 
a 32-bit number. That’s why it’s called a 32-bit system. 32 bits == 4 
bytes. That’s why a 64-bit system uses 8 bytes to store an address. 


On most systems? So it J s not guaranteed? 


It's not guaranteed. 
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memory and pointers 


MPtt? 6 M 4 E 


We have a classic trio of bachelors ready to play The Mating 
Game today. 

Tonight’s lucky lady is going to pick one of these fine contestants. 
Who will she choose? 


Cowbesta 灼七 I 


Look ai -the 

匕 ode below ； 

扣 d wv-i-tc you 浐 

^hswcir hcv-c. 



#include <stdio.h> 

int main() 

{ 

int contestants[] = {1, 2, 
int ^choice = contestants; 

= 2 ; 


3} 


contestants [ 0]= 
contestants [ 1] = contestants [2]; 
contestants[2] = ^choice; 

printf("1 1 m going to pick contestant number %i\n n , 
return 0; 


contestants [2]) 
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date picked 



SQiUTiOM 


We had a classic trio of bachelors ready to play The Mating Game 
today. 

Tonight’s lucky lady picked one of these fine contestants. Who did 
she choose? 


Cowbesta 灼七 I 



#include <stdio.h> 


int main() 

{ 

int contestants[] = {1, 2, 
int ^choice = contestants; 

= 2 ; 


3} 


is how the olddv-css o-f the 
^Ohtcs-tclh-ts^ a\rvay. 

二二 ^cMoiCe. 


^ov\icsiav\^C03 

1 


contestants [ 0]= 

contestants [ 1] = contestants [2]; 
contestants[2] = ^choice; 
printf("1 1 m going to pick contestant number %i\n n , contestants[2]) 
return 0; 
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memory and pointers 


Put array variables aren't quite pointers 

Even though you can use an array variable as a pointer, there 
are still a few differences. To see the differences, think about this 
piece of code. 


char s[] = "How big is it ? n ; 
char = s; 



sizeof (an array) is...the size of an array. 

You’ve seen that sizeof (a pointer) returns the value 4 or 8, 
because that’s the size of pointers on 32 - and 64-bit systems. But if you 
call sizeof on an array variable, G is smart enough to understand that 


what you want to know is how big the array is in memory. 



o w b 


T\)\s is i\\t i po'm-tev-. 
siz^o-f is o^r 0- 


\o 


This \retums 午 ov» 0. 


Tii'is \re*tu\nr\S I 弓 . 

sizeof(s) 


sizeof(t) 



The address of the array...is the address of the array. 

A pointer variable is just a variable that stores a memory address. But 
what about an array variable? If you use the & operator on an array 
variable, the result equals the array variable itself. 


&S == S &t != t 

If a coder writes &s, that means “What is the address 
of the s array?” The address of the s array is just … s. 
But if someone writes that means “What is the 
address of the t variable?’’ 



An array variable can't point anywhere else. 

When you create a pointer variable, the machine will 
allocate 4 or 8 bytes of space to store it. But what if 
you create an array? The computer will allocate space 
to store the array, but it won’t allocate any memory to 
store the array variable. The compiler simply plugs in 
the address of the start of the array. 


But because array variables don’t have allocated 
storage, it means you can’t point them at anything else. 

TWis will a s = t ; 


Pointer decay 

Because array variables are slightly 
I different from pointer variables, you need 
to be careful when you assign arrays 
I to pointers. If you assign an array to a 
pointer variable, then the pointer variable 
will only contain the address of the array. 
I The pointer doesn’t know anything about 
I the size of the array, so a little information 
has been lost. That loss of information is 
I called decay. 

Every time you pass an array to a 
I function, you’ll decay to a pointer, so 
it’s unavoidable. But you need to keep 
track of where arrays decay in your code 
because it can cause very subtle bugs. 
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five-minute mystery 


The Case of the Lethal List 


The mansion had all the things he’d dreamed of: landscaped grounds, 
chandeliers, its own bathroom. The 94-year-old owner, Amory 
Mumford III, had been found dead in the garden, apparently of a 
heart attack. Natural causes? The doc thought it was an overdose of 
heart medication. Something stank here, and it wasn’t just the dead 
guy in the gazebo. Walking past the cops in the hall, he approached 


Flve^ 

鄭 ter 


卿晰 


Mumford’s newly widowed 2 7-year-old wife, Bubbles. 

“I don’t understand. He was always so careful with his medication. 
Here’s the list of doses.” She showed him the code from the drug 
dispenser. 


int doses[] = {1, 3, 2, 1000}; 


“The police say I reprogrammed the dispenser. But I’m no good with 
technology. They say I wrote this code, but I don’t even think it’ll 
compile. Will it?’’ 


She slipped her manicured fingers into her purse and handed him a 
copy of the program the police had found lying by the millionaire’s bed. 
It certainly didn’t look like it would compile... 


printf ("Issue dose %i", 3[doses]); 


What did the expression 3 [doses ] mean? 3 wasn’t an array. Bubbles 
blew her nose. “I could never write that. And anyway, a dose of 3 is not 
so bad, is it?” 

A dose of size 3 zvouldn^t have killed the old guy. But 
maybe there zvas more to this code than met the eye... 
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memory and pointers 


Why arrays really start at 0 

An array variable can be used as a pointer to the first element in an 
array. That means you can read the first element of the array either 
by using the brackets notation or using the * operator like this: 


These lihes 
Code 

C^uivalcht. 


int drinks[ 


^^printf ( n 1st 
printf( n 1st 


={4, 
order : 
order : 


2, 3}; 

%i drinks\n", 
%i drinks\n ", 


drinks [0]);^ 如 _] 二二踏 ‘ 
* dr inks) ; ^ —〆 


But because an address is just a number, that means you can do 
pointer arithmetic and actually add values to a pointer value 
and find the next address. So you can either use brackets to read 
the element with index 2, or you can just add 2 to the address of 
the first element: 

printf("3rd order : %i drinks\n n , drinks[2]); 

printf ("3rd order : %i drinks\n f, , * (drinks + 2)); 

In general, the two expressions drinks [ i ] and * (drinks + i) 
are equivalent. That’s why arrays begin with index 0. The index is 
just the number that’s added to the pointer to find the location of 
the element. 


This is at 
lodatioh U d\r'mks. W 



TWis is a 七 
w a/mks + z." 







少 

TVis is a 七 'dv-mks + I. 



Use the power of pointer arithmetic to mend a broken heart. This 
function will skip the first six characters of the text message. 


void skip(char *msg) 


puts ( 


char *msg from amy = 


do you *to 



"Don't 


call 


The -Pu^diio^ needs "to 七 his 

message -P\rom 七 he V dhavadiev- o^. 

me ; 


skip(msg from amy); 


you are here ► 
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pointers and types 


parpen your pencil 

Solution 


You were to use the power of pointer arithmetic to mend a 
broken heart. This function skips the first six characters of the 
text message. 


void skip(char *msg) 


puts ( 






|-f you add ^ -to msj fomtcv-, 
you y/'lll -fv-om ^av-at*tcv- 1- 


char *msg_from_amy = "Don't call me 
skip(msg from amy); 


V 


o 


Y\ 


t 


a 


t 


\0 


T 

po*m*ts here. 


f 


The Code will display 七 his. 


+ 么 foists -to the Icttcv- 


I File Edit Window Help 


> ./skip 
call me 

> 


Why pointers have types 


If pointers are just addresses, then why do pointer variables have types? 
Why can’t you just store all pointers in some sort of general pointer 
variable? 

The reason is that pointer arithmetic is sneaky. If you add 1 to a 
char pointer, the pointer will point to the very next memory address. 
But that’s just because a char occupies 1 byte of memory. 

What if you have an int pointer? ints usually take 4 bytes of space, 
so if you add 1 to an int pointer, the compiled code will actually add 
4 to the memory address. 



[ 上 nt *l 「 char* J 


「 long* j 




pom-tev variables have 

■types -fov of 



int nums[] = {1, 2, 3}; 

printf("nums is at %p\n n , nums); 

printf("nums + 1 is at %p\n n , nums + 1); 


If you run this code, the two memory address will be more than one 
byte apart. So pointer types exist so that the compiler knows how 
much to adjust the pointer arithmetic. 


*M) is 午 bytes ^ 
awy -p\rorh hums. 


I File Edit Window Help 


> . / print_nums , _ 

nums is at 0x7fff66ccedac 
nums + 1 is at 0x7fff66ccedb0 


Rcw'CW'fecV", *bV^csc 
addresses avc 卜 W 
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memory and pointers 


The Case of the Lethal List 

Last time voe left our hero interviewing Bubbles Mumford, 
ivhose husband had been given an overdose as a result of 
suspicious code. Was Bubbles the coding culprit or just a 
patsy? To find out，read on... 

He put the code into his pocket. “It’s been a pleasure, Mrs. Mumford. I don’t 
think I need to bother you anymore.” He shook her by the hand. “Thank you,” 
she said, wiping the tears from her baby blue eyes, “You’ve been so kind.” 

“Not so fast, sister.” Bubbles barely had time to gasp before 
he’d slapped the bracelets on her. “I can tell from your 
hacker manicure that you know more than you say about 
this crime.” No one gets fingertip calluses like hers without 
logging plenty of time on the keyboard. 

“Bubbles, you know a lot more about G than you let on. Take 
look at this code again.” 



int doses[] = {1, 3, 2, 1000}; 
printf (’ ▼ Issue dose %i n , 3[doses]); 


“I knew something was wrong when I saw the expression 3 [ doses ] . You 
knew you could use an array variable like doses as a pointer. The fatal 1,000 
dose could be written down like this …” He scribbled down a few coding 
options on his second-best Kleenex: 


doses [3] —— *(doses + 3) == *(3 + doses) — 3[doses] 

“Your code was a dead giveaway, sister. It issued a dose of 1,000 to the old guy. 
And now you’re going where you can never corruptly use G syntax again...” 


you are here ► 
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no dumb questions 


I^^BUUET POINTS — 

■ Array variables can be used as 
pointers... 

■ ...but array variables are not quite 
the same. 

■ sizeof is different for array and 
pointer variables. 

■ Array variables can’t point to 
anything else. 


Passing an array variable to a pointer 
decays it. 

Arrays start at zero because of 
pointer arithmetic. 

Pointer variables have types so they 
can adjust pointer arithmetic. 


tKereiare no o 

Dumb Questi9ns 


Do I really need to understand pointer arithmetic? 

Some coders avoid using pointer arithmetic because it’s 
easy to get it wrong. But it can be used to process arrays of data 
efficiently. 


Can I subtract numbers from pointers? 

Yes. But be careful that you don’t go back before the start of 
the allocated space in the array. 

When does C adjust the pointer arithmetic calculations? 

It happens when the compiler is generating the executable. It 
looks at the type of the variable and then multiplies the pluses and 
minuses by the size of the underlying variable. 


Go on... 

If the compiler sees that you are working with an int array 
and you are adding 2, the compiler will multiply that by 4 (the length 
of an int) and add 8. 

Does C use the sizeof operator when it is adjusting 
pointer arithmetic? 

Effectively. The sizeof operator is also resolved at 
compile time, and both sizeof and the pointer arithmetic 
operations will use the same sizes for different data types. 

Can I multiply pointers? 

A: No . 
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memory and pointers 


Using pointers for data ewtry 

You already know how to get the user to enter a string from the 
keyboard. You can do it with the scanf () function: 


▼ ); 

s 匕 ayvf v/ill vc 3 d uf *to ^ 

plus 七 he \ 0 . 

How does scanf () work? It accepts a char pointer, and in this 
case you’re passing it an array variable. By now, you might have 
an idea why it takes a pointer. It’s because the scanf () function 
is going to update the contents of the array. Functions that need to 
update a variable don’t want the value of the variable itself — they 
want its address. 


V 0[A ^ Joihg -to s^ovc d char name [40]; 

ih -this avray. printf ("Enter your name : 

scanf ( n %39s n , name) ; 一 


Entering numbers with scawfO 

So how do you enter data into a numeric field? You do it by 
passing a pointer to a number variable. 

int age; 

%i rwcahs the usev- will printf ("Enter your age : "); 

Chtcv- By\ ih-t value. scanf ("%i" , &age) ; €, k 七七 ^ addv-css he m 


Because you pass the address of a number variable into the 
function, scanf () can update the contents of the variable. 
And to help you out, you can pass a format string that contains 
the same kind of format codes that you pass to the printf () 
function. You can even use scanf () to enter more than one 
piece of information at a time: 

char first name[20]; 


0^ 





Br)le^r up -to V\ dhavad-tevs (+ 'NoO. 


I %f 


Uitr a 公 oa 七 I 十?“七卿 


This v-cads a char last—name [20]; 


v\a^, tkh 
a thch the 
sedohd 


printf ("Enter first and last name : ’▼); 

scanf("%19s %19s ", first 一 name, last 一 name)/ 

printf("First : %s Last : %s\n n , first name A last 


name); 


File Edit Window Help Meerkats 


> ./name 一 test 

Enter first and last name : Sanders Kleinfeld 
First: Sanders Last: Kleinfeld 

> 


丁 he +i\rst av\d last hdmes 狀 e 
s{x>v-cd ih sepavate avvays. 
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scanff) can cause overflows 


Pe careful with scanfO 

There’s a little.. .problem with the scanf () function. So 
far, all of the code you’ve written has very carefully put a limit 
on the number of characters that scanf () will read into a 
function: 

scanf ( n %39s, name) ; / 

scanf ("%2s", card 一 name); 

Why is that? After all, scanf () uses the same kind of format 
strings as printf (), but when we print a string with printf (), 
you just use %s. Well, if you just use %s in scanf (), there can 
be a problem if someone gets a little type-happy: 

char food[5]; 

printf ("Enter favorite food : ’▼); 
scanf("%s n , food); 

printf ("Favorite food : %s\n f, , food); 


File Edit Window Help TakeAByte 


> ./food 

Enter favorite food: liver-tangerine-raccoon-toffee 
Favorite food: liver-tangerine-raccoon-toffee 
Segmentation fault: 11 

> 


The program crashes. The reason is because scanf () writes 
data way beyond the end of the space allocated to the food array. 


scanf(l caw cause buffer overflows 

If you forget to limit the length of the string that you read with 
scanf () ， then any user can enter far more data than the 
program has space to store. The extra data then gets written into 
memory that has not been properly allocated by the computer. 
Now, you might get lucky and the data will simply be stored and 
not cause any problems. 

But it’s very likely that buffer overflows will cause bugs. It might 
be called a segmentation fault or an abort trap, but whatever the 
error message that appears, the result will be a crash. 


This is the 

-Pood av-v-av- 


The -food av"\ray 


V 


e 


r 


EvCVY 仏 \>Oj0Y\d 
\ciicr \r is outside 

i\\t av-v-ay* 


夕 


a 


n 


F\rom the U —^ 
Oh ， 七 liis C.odt is 
•… ill— spade. 
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memory and pointers 


fgetsO is an alternative to scanfO 

There’s another function you can use to enter text data: 
fgets () .Just like the scanf () function, it takes a char 
pointer, but unlike the scanf () function, the fgets () 
function must be given a maximum length: 


the « 一 ^ char food [5]; 

Plrogirarw 

as bc-rov-c printf ("Enter favorite food : ’▼); 

fgets(food, sizeof(food), stdin); 


^onr\*bcv" *to 3 



个 

Ne 此 ii -takes a maximum si 
the st\rmg C/0 } i^luded). 


That means that you can’t accidentally forget to set a length 


s 七 dm j uS 七 

dd*bd You’ll *f’md oia 七 

-f\row 七 ^ — ^ rwo\rc dbou 七 

stdm latc\r. 


when you call fgets (); it’s right there in the function 
signature as a mandatory argument. Also, notice that the 
fgets () buffer size includes the final \0 character. So 
you don’t need to subtract 1 from the length as you do with 
scanf(). 

OK, what else do you need to know about 
fgets()? 

Using sizeof with fgetsO 

The code above sets the maximum length using the sizeof 
operator. Be careful with this. Remember: sizeof returns 
the amount of space occupied by a variable. In the code 
above, food is an array variable, so sizeof returns the 
size of the array. If food was just a simple pointer variable, 
the sizeof operator would have just returned the size of a 
pointer. 

If you know that you are passing an array variable to 
fgets () function, then using sizeof is fine. If you’re 
just passing a simple pointer, you should just enter the size 



The fgets() function 
actually comes from an 
older function called 
gets(). 


No。。。。。。""/ 
Seriously, 
doh’t use 
this. 


Even though fgets () is seen 
as a safer-to-use function than 
scanf (), the truth is that the 
older gets () function is far 
more dangerous than either of 
them. The reason? The gets () 
function has no limits at all; 

char dangerous[10]; 
gets(dangerous)/ 


you want: 


1 ( -Pood v/as a simple 

you’d jive v 

C 乂 plidrt \raihcv 

sizjCot. 


printf ("Enter favorite food : ’▼); 
fgets(food, 5, stdin); 


gets () is a function that’s 
been around for a long time. 
But all you really need to know 
is that you really shouldn’t 
use it. 
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scanfQ vs fgetsQ 




Roll up! Roll up! It’s time for the title fight we’ve all been waiting for. In the 
red corner: nimble light, flexible but oh-so-slightly dangerous. It’s the bad 
boy of data input: scanf (). And in the blue corner, he’s simple, he’s safe, 
he’s the function you’d want to introduce to your mom: it’s f gets ()! 


Round 1: Limits 

Do you limit the number of 
characters that a user can 
enter? 


scanf(): 

scanf () can limit the data 
entered, so long as you remember 
to add the size to the format string. 


fgets ()： 

f gets () has a mandatory limit 
Nothing gets past him. 


Result: fgetsQ takes this round on points. 


Round 2: Multiple fields 

Can you be used to enter 
more than one field? 


Yes! scanf () will not only allow 
you to enter more than one field, 
but it also allows you to enter 

structured data including the 
ability to specify what characters 
appear between fields. 


Ouch! fgets () takes this one on 
the chin, fgets () allows you to 
enter just one string into a buffer. 
No other data types. Just strings. 
Just one buffer. 


Result: scanfQ clearly wins this round. 


Round 3: Spaces in strings 

If someone enters a string ， 
can it contain spaces? 


Oof! scanf () gets hit badly by 
this one. When scanf () reads a 
string with the %s, it stops as soon 
as it hits a space. So if you want 
to enter more than one word, you 
either have to call it more than 
once, or use some fancy regular 
expression trick. 


No problem with spaces at all. 
fgets () can read the whole 
string every time. 


Result: A fightback! Round to fgetsQ. 


A good clean fight between these two feisty functions. Clearly, if you need to enter 
structured data with several fields, you'll want to use scanf (). If you’re entering 
a single unstructured string, then f gets () is probably the way to go. 
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Anyone for three-card mowtc? 

In the back room of the Head First Lounge, there’s a game 
of three-card monte going on. Someone shuffles three cards 
around, and you have to watch carefully and decide where you 
think the Queen card went. Of course, being the Head First 
Lounge, they’re not using real cards; they’re using code. Here’s the 
program they’re using: 


^include <stdio.h> 

int main() 

{ 

char *cards = "JQK"; 
char a_card = cards[2]; 
cards[2] = cards[1]; 


cards[1]= 
cards[0]= 
cards[2]= 
cards[1]= 
puts(cards); 
return 0; 


cards[0]; 
cards[2]; 
cards[1]; 
a card; 


The code is designed to shuffle the letters in the three-letter 
string “JQK.” Remember: in G, a string is just an array of 
characters. The program switches the characters around and 
then displays what the string looks like. 

The players place their bets on where they think the “Q” letter 
will be, and then the code is compiled and run. 



memory and pointers 
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memory problems 


Oops...thcrG's a memory problem.. 

It seems there’s a problem with the card shark’s code. When 
the code is compiled and run on the Lounge’s notebook 
computer, this happens: 


Darn it. I knew that 
card shark couldn’t be 
trusted... 



File Edit Window Help HolyCrap 


> gcc monte.c -o monte && ./monte 
monte.exe has stopped working 


^egp^aurt! 


Kapow 


Error! 


What’s more, if the guys try the same code on different 
machines and operating systems, they get a whole bunch of 
different errors: 


Filp FHit Window Hp»ln Plar.pRpt I 


> gcc monte.c 一 o monte && ./monte 
bus error 


What’s wrong with the code? 
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memory and pointers 


+ cf 餐 

• + 

It’s time to use your intuition. Don’t overanalyze. Just take a guess. 
Read through these possible answers and select only the one you think is 
correct. 

What do you think the problem is? 


The string can’t be updated. 


We're swapping characters outside the string. 


The string isn’t in memory. 


Something else. 
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gut instinct 


It was time to use your intuition. You were to read through these 
possible answers and select only the one you think is correct. 

What did you think the problem was? 


The string can’t be updated. 

v/ 

We're swapping characters outside the string. 


The string isn’t in memory. 


Something else. 



String literals can wcver be updated 

A variable that points to a string literal can’t be used to change 
the contents of the string: 

char *cards = n JQK"; ^ 丁 W» s variable modAy tw»s 

But if you create an array from a string literal, then you can 
modify it: 

char cards[] = "JQK"; 

It all comes down to how C uses memory … 
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memory and pointers 



So the problem is that string literals like 
“JQK” are held in read only memory. They’re 
constants. 


But if that’s the problem, how do 
you fix it? 




Lowest address 
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Iw memory: char *cards-"J(lK"; 

To understand why this line of code causes a memory error, we 
need to dig into the memory of the computer and see exactly 
what the computer will do. 


rt 吵 CS 七 addvess 


o The computer loads the string literal. 

When the computer loads the program 
into memory, it puts all of the constant 
values — like the string literal U JQK ?, 一 into 
the constant memory block. This section of 
memory is read only. 

❺ The program creates the cards 
variable on the stack. 

The stack is the section of memory that the 
computer uses for local variables: variables 
inside functions. The cards variable will live 
here. 

o The cards variable is set to the 
address of 

The cards variable will contain the address 
of the string literal String literals 

are usually stored in read-only memory to 
prevent anyone from changing them. 

o The computer tries to change the 
string. 

When the program tries to change the 
contents of the string pointed to by the cards 
variable, it can’t; the string is read-only. 



















































































copy and change 


If youYe going to change a string, make a copy 


The truth is that if you want to change the contents of a string, 
you’ll need to work on a copy. If you create a copy of the 
string in an area of memory that’s not read-only, there won’t be 
a problem if you try to change the letters it contains. 

But how do you make a copy? Well, just create the string as a 
new array. 

^\rds is hot just 

char cards [ ] = " JQK" ; ^ — - a poihtcv-. davds 

is how sv\ av-v-ay. 


It’s probably not too clear why this changes anything. All 
strings are arrays. But in the old code, cards was just a pointer. 
In the new code, it’s an array. If you declare an array called 
cards and then set it to a string literal, the cards array will 
be a completely new copy. The variable isn^ just pointing at the 
string literal. It’s a brand-new array that contains a fresh copy 
of the string literal. 

To see how this works in practice, you’ll need to look at what 
happens in memory. 


ThiS is ih w 叫 y 


J Q K \0 


■•it 


J 

Q 

K 

\0 


个 


..SO rrs 


_ake a strmj m a 

scdtior^ o-f mcmov-y i\\Bi c.By\ be amended- 


Gee| Bits - 

cardsn or cards*? 


If you see a declaration like this, what does it really 
mean? 


But if cards is being declared as a function argument, it 
means that cards is a pointer: 


char cards[] 

Well, it depends on where you see it. If it’s a normal 
variable declaration, then it means that cards is an 
array, and you have to set it to a value immediately: 

int my—function() 

{ 

^av-ds char cards [] = " JQK n ; 

ah y\o a^ay s\z£ jwen, so you V^avc 

•to sc*t "»*t *to Sow>C*t^'m5 immcdia-tcly- 




void stack deck(char cards[]) 

{ — 个 

• • • ^drds is a ^av- fo'm-tev-. 


void stack—deck(char *cards) 
{ 一 


These -two av-c c^uivalc^-t. 
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memory and pointers 


Iw memory: char cardsli-'JftlC; 


We’ve already seen what happens with the broken code, 
but what about our new code? Let’s take a look. 


o 


❺ 


The computer loads the string literal. 

As before, when the computer loads the 
program into memory, it stores the constant 
values 一 like the string U JQK ?, 一 into read-only 
memory. 


address 


The program creates a new array on 
the stack. 

We’re declaring an array, so the program will 
create one large enough to store the U JQK ?, 
string — four characters ， worth. 





STACK 




j 


Q 


K 


\0 





IUIAV 


O The program initializes the array. 

But as well as allocating the space, the 
program will also copy the contents of the 
string literal U JQK ?, into the stack memory. 


So the difference is that the original code 
used a pointer to point to a read-only string 
literal. But if you initialize an array with 
a string literal, you then have a copy of the 
letters, and you can change them as much as 
you like. 






FLORALS 




◊ 





々 J〆 Q ， K ， \0 



char cards [ ] = f! JQK ff 


• • • 


cards [2] = cards [lTT^) 


CODK- 


Lov/est address 
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test drive 



Tqst DriVQ 


See what happens if you construct a new array in the code. 


^include <stdio.h> 

int main() 

{ 

char cards[] = "JQK"; 
char a_card = cards[2]; 
cards[2] = cards[1]; 


I File Edit Window Help Where’sTheLadv? 


> gcc monte.c -o monte && ./monte 
QKJ 


cards[1] 
cards[0] 
cards[2] 
cards[1] 
puts(cards); 
return 0; 


cards[0]; 
cards[2]; 
cards[1]; 
a card; 



was the first 
card. I knew it.. 



The code works! Your cards variable now points to a string in an 
unprotected section of memory, so we are free to modify its contents. 



6ee} BifS 





One way to avoid this problem in the future is to never write code that sets a simple char pointer to a string 
literal value like: 


char *s = "Some string"; 

There’s nothing wrong with setting a pointer to a string literal — the problems only happen when you try to 
modify a string literal. Instead, if you want to set a pointer to a literal, always make sure you use the const 
keyword: 

const char *s = "some string"; 

That way, if the compiler sees some code that tries to modify the string, it will give you a compile error: 

s[0] = 'S'; 

monte.c:7: error : assignment of read-only location 
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memory and pointers 


The Case of the Magic Bullet 

He was scanning his back catalog of Guns ， n’ Ammo into Delicious Library when there was 
a knock at the door and she walked in: 5' 6", blonde, with a good laptop bag and cheap 
shoes. He could tell she was a code jockey. “You’ve gotta help me.. .you gotta clear his 
name! Jimmy was innocent, I tells you. Innocent!” He passed her a tissue to wipe the tears 
from her baby blues and led her to a seat. 

It was the old story. She’d met a guy, who knew a guy. Jimmy Blomstein worked tables at 
the local Starbuzz and spent his weekends cycling and working on his taxidermy collection. 
He hoped one day to save up enough for an elephant. But he’d fallen in with the wrong 
crowd. The Masked Raider had met Jimmy in the morning for coffee and they’d both 
been alive: 


char masked—raider[] = "Alive"; 


char *jimmy = masked—raider; 


Flve^lnute 

Mystery 



printf("Masked raider is %s, Jimmy is %s\n M , masked—raider, 
jimmy); 


File Edit Window Help 


Masked raider is Alive, 



is Alive 


Then, that afternoon, the Masked Raider had gone off to pull a heist, like a hundred 
heists he’d pulled before. But this time, he hadn’t reckoned on the crowd of G-Men 


enjoying their weekly three-card monte session in the back room of the Head First 
Lounge. You get the picture. A rattle of gunfire, a scream, and moments later the villain 
was lying on the sidewalk, creating a public health hazard: 


masked—raider[0] = 1 D 1 ; 
masked—raider[1] = 1 E 1 ; 
masked—raider[2] = 1 A 1 ; 
masked—raider[3] = 1 D 1 ; 

masked—raider[4] = '!'; 


Problem is, when Toots here goes to check in with her boyfriend at the coffee shop, she’s 
told he’s served his last orange mocha frappuccino: 

printf("Masked raider is %s, Jimmy is %s\n n , masked—raider, jimmy)/ 



So vohat gives? Hovo come a single magic bullet killedJimmy and the 
Masked Raider? What do you think happened? 
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case solved 


The Case of the Magic Bullet 

Hovo come a single magic bullet killedJimmy and the Masked Raider? 

Jimmy, the mild-mannered barista, was mysteriously gunned down at the same time as arch-fiend the 
Masked Raider: 


^include <stdio.h> 
int main() 

{ 

char masked—raider[] = "Alive"; 
char *jimmy = masked—raider; 

printf("Masked raider is %s, Jimmy is %s\n M , masked—raider, jimmy); 
masked—raider[0] = 'D 
masked—raider[1] = 1 E 
masked—raider[2] = 1 A 
masked 一 raider[3] = ' D 
masked—raider[4 ] = ' ! 
printf("Masked raider is %s, Jimmy is %s\n n , masked—raider, jimmy)/ 
return 0; 


d\^ pvodud 

七 。 V Booster dHhk; the deal -fell though. 


It took the detective a while to get to th^bottom of the mystery. While he was waiting, 
he took a long refreshing sip from a Head First Brain Booster Fruit Beverage. He sat 
back in his seat and looked across the desk at her blue, blue eyes. She was like a rabbit caught 
in the headlights of an oncoming truck, and he knew that he was at the wheel. 

“I’m afraid I got some bad news for you. Jimmy and the Masked Raider.. .were one and the same man! 



5 ? 


“No! 




She took a sharp intake of breath and raised her hand to her mouth. u Sorry, sister. I have to say it how I 
see it. Just look at the memory usage.” He drew a diagram: 


masked raider 



jimmy 









“ j immy and masked—raider are just aliases for the same memory address. They’re pointing to the 
same place. When the masked—raider stopped the bullet, so did Jimmy. Add to that this invoice 
from the San Francisco elephant sanctuary and this order for 15 tons of packing material, and it’s an 
open and shut case.” 
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memory and pointers 


(^^BULIET POINTS - 

■ If you see a ★ in a variable declaration, 
it means the variable will be a pointer. 

■ String literals are stored in read-only 
memory. 


■ If you want to modify a string, you need 
to make a copy in a new array. 

■ You can declare a char pointer as 
const char * to prevent the code 
from using it to modify a string. 


Why didn’t the compiler just tell 
me I couldn’t change the string? 

Because we declared the cards 
as a simple char *, the compiler didn’t 
know that the variable would always be 
pointing at a string literal. 

Why are string literals stored in 
read-only memory? 

Because they are designed to be 
constant. If you write a function to print 
“Hello World,” you don’t want some other 
part of the program modifying the “Hello 
World” string literal. 

Do all operating systems enforce 
the read-only rule? 

The vast majority do. Some 
versions of gcc on Cygwin actually 
allow you to modify a string literal without 
complaining. But it is always wrong to do 
that. 



What does const actually 
mean? Does it make the string read¬ 
only? 

String literals are read-only anyway. 
The const modifier means that the 
compiler will complain if you try to modify 
an array with that particular variable. 

Do the different memory 
segments always appear in the same 
order in memory? 

They will always appear in the same 
order for a given operating system. But 
different operating systems can vary the 
order slightly. For example, Windows 
doesn’t place the code in the lowest 
memory addresses. 

I still don’t understand why an 
array variable isn’t stored in memory. If 
it exists, surely it lives somewhere? 

When the program is compiled, all 
the references to array variables are 
replaced with the addresses of the array. 
So the truth is that the array variable 
won’t exist in the final executable. That’s 
OK because the array variable will never 
be needed to point anywhere else. 


If I set a new array to a string 
literal, will the program really copy the 
contents each time? 

It’s down to the compiler. The final 
machine code will either copy the bytes 
of the string literal to the array, or else 
the program will simply set the values of 
each character every time it reaches the 
declaration. 

You keep saying “declaration ■” 
What does that mean? 

A declaration is a piece of code that 
declares that something (a variable, a 
function) exists. A definition is a piece of 
code that says what something is. If you 
declare a variable and set it to a value 
(e.g., int x = 4 ；), then the code is 
both a declaration and a definition. 

Why is scanf () called 
scanf () ? 

scanf () means “scan formatted” 
because it’s used to scan formatted input. 
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memory reminder 


Memory memorizer 

Stack 

This is the section of memory used for local 
variable storage. Every time you call a 
function, all of the function’s local variables 
get created on the stack. It’s called the stack 
because it’s like a stack of plates: variables get 
added to the stack when you enter a function, 
and get taken off the stack when you leave. 
Weird thing is, the stack actually works upside 
down. It starts at the top of memory and 
grows downward. 


Heap 

This is a section of memory we haven’t 
really used yet. The heap is for dynamic 
memory: pieces of data that get created 
when the program is running and then hang 
around a long time. You’ll see later in the 
book how you’ll use the heap. 


Globals 

A global variable is a variable that lives 
outside all of the functions and is visible to 
all of them. Globals get created when the 
program first runs, and you can update them 
freely. But that’s unlike … 


Constants 

Constants are also created when the program 
first runs, but they are stored in read-only 
memory. Constants are things like string 
literals that you will need when the program 
is running, but you’ll never want them to 
change. 

Code 

Finally, the code segment. A lot of operating 
systems place the code right down in the 
lowest memory addresses. The code segment 
is also read-only. This is the part of the 
memory where the actual assembled code 
gets loaded. 



1 

£ 

■S 




LINK A6, #VARSIZE - 

MOVEM 丄 D0-D7/A1-A5,<SP) 
-MOVE.L SP ， SAVESTK(A6) — 

—MOVE 丄 SP ， SAVEAS(A6) 

MOVE 丄 GRAFGL0BALS(A5) ， A0 



“west address 
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memory and pointers 



Your C Toolbox 


You’ve got Chapter 2 under 
your belt, and now you’ve 
added pointers and memory to 
your toolbox. For a complete list of 
tooltips in the book, see Appendix ii. 


Will allo>w a 

vaSCV 

a v\iawV)CV ^ 


a\r C 

di ^Cyii siz^s 

° h di ^ Ch i 


vaviaWe x k 
dctlavcd as 

Aav" 氺乂 . 


a ^ 

㈣ 十 a 

fcr— ， ^ 
一 UofT 七 . 


S*t\rihg literals 
3\rc s*to\rcd 
•m read - ohly 

r^Cnr»o\ry. 


Redd 

a 灼 addivess a 
Y/Vth 决丑 . 



*fyts(bu*f, s'izjC ； 
s*tdih) is a 
simpler way *to 
Ch*tc\r 七€此 


CHAPTER 2 
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2-5 strings 


餐 String theory 命 



There’s more to strings than reading them. 

You’ve seen how strings in C are actually char arrays but what does C allow you to do 
with them? That’s where string.h comes in. string.h is part of the C Standard Library 
that’s dedicated to string manipulation. If you want to concatenate strings together, 
copy one string to another, or compare two strings, the functions in string. h are there to 
help. In this chapter, you’ll see how to create an array of strings, and then take a close 
look at how to search within strings using the strstr () function. 
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string searches 


Frawk 

Pcspcratdy seeking 

There are so many tracks on the retro jukebox that people can’t find 
the music they are looking for. To help the customers, the guys in the 
Head First Lounge want you to write another program. 

This is the track list: 


TVatks ^ ， album w LiUlc SmaVa” 



TraoK Us 七 

'heart in Harvard med School 
MeioarK ； MetoarK - a toondertul 七 ou)n 
Danoino^ u)\-th 0 DorK 
From here -to ma-temi-ty 
line o^irl ^-rom \u)o Jima 



The guys say iUai tkv-c will be lots ⑽代 
tv-adks m the -pu-tu\rc, but they II hevev- be 

州 。代 thah 1 °{ (ihav-adev-s U 3 . 


The list is likely to get longer, so there’s just the first few tracks for 
now. You’ll need to write a G program that will ask the user which 
track she is looking for, and then get it to search through all of the 
tracks and display any that match. 





Gah! Wayne Newton... 
again! We need a search 
program to help people find 
tracks on the jukebox. 



There’ll be lots of strings in this program. How do you think you can 
record that information in C? 
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strings 


Create aw array of arrays 

There are several track names that you need to record. You can record 
several things at once in an array. But remember: each string is itself an 
array. That means you need to create an array of arrays, like this: 


This Usi sci is 

^ay of a || “沪 

T\\t tell char tracks [] [80] 

you V^avc 


S'tv'I^S) SO you do\r\ *t 

a bcWcy\ these 

bv-atkc*b. 

s*br’m3 is 扣 

av-v-ay, so tlVis is an 
av-v-ay <^c av-v-ays. 


Tk SCdo\r\d SC*t W3^kc*ts is 

used -fov- ca^ rndWid^al <-^y ou |^ oy/ ^a*t *tv-adk 

y>ames v/'ill y>cvcv yt lo^^CV 
:{ -t^ar^ l°i so sei 

n I left my heart in Harvard Med School" , 七 k value *to ^O. 



"Newark, Newark - a wonderful town 
"Dancing with a Dork ", 

"From here to maternity ", 

"The girl from 工 wo Jima n , 


The array of arrays looks something like this in memory: 

-- ^ Chav-ad*tcv-s B s*t\r*mg 


E 把 h sohg title will be allotted 

dhav-ol^-tcv-s. 



So now that you know how to record the data in G, what do you 
need to do with it? 
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library code 


Find strings cowtaiwmg the search text 


The guys have helpfully given you a spec. 


Well, you know how to record the tracks. You also know how to 
read the value of an individual track name, so it shouldn’t be too 
difficult to loop through each of them. You even know how to ask 
the user for a piece of text to search for. But how do you look to 
see if the track name contains a given piece of text? 


Using striwg.h 


The C Standard Library is a bunch of useful code that you 
get for free when you install a G compiler. The library code 
does useful stuff like opening files, or doing math, or managing 
memory. Now, chances are, you won’t want to use the whole of the 
Standard Library at once, so the library is broken up into several 
sections, and each one has a header file. The header file lists all 
of the functions that live in a particular section of the library. 


4 


你冰咖 e W 
\。。， V0 (. 


So far, you have only really used the stdio.h header file, stdio.h lets 
you use the standard input/output functions like printf and 
scanf. 


But the Standard Library also contains code to process strings. 
String processing is required by a lot of the programs, and the 
string code in the Standard Library is tested, stable, and fast. 



Compare two strings 
to eacli odier 


iVtake a copy of ^ 術 ㈣ 


arcK for ^ 如如总 

Slice a string ixrtc 
little pieces 




You include the string code into your program using the string, h 
header file. You add it at the top of your program, just like you 
include stdio.h. 


#include 〈 stdio.h 〉 W^T^youll wsc Wth s*td»o.K ay\d 

#include〈string • h>\ 如 + m f 
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strings 


1 猶 









See if you can match up each string.h function with the description of 
what it does. 


strcjir() 


strcmpO 


strstrO 


strcp/0 


strlen() 


strcqtO 


Concatenate two strings. 


Find the location of a string inside 
another string. 


Find the location of a character inside 
a string. 


Find the length of a string. 


Compare two strings. 


Copy one string to another. 



Which of the functions above should you use for the jukebox 
program? Write your answer below. 
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whafs my purpose 


♦ + 




rpen your pencil 
Solution 


You were to write which of the above functions you should use 
for the jukebox program. 


st\rs*tvO 
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Using the strstrO fuwctiow 

So how exactly does the strstr () function work? Let’s look at an 
example. Let’s say you’re looking for the string “fun” inside a larger 
string, “dysfunctional.” You’d call it like this: 


strstr("dysfunctional ", "fun") 


VbvstvO Will ^\y\d 
V^c\rc a-t lotatuw 


y 


\ 


u 

n 

小 


S 

Ml 

u|| 

n 

c 

t 

• 

1 
























The strstr () function will search for the second string in the first 
string. If it finds the string, it will return the address of the located 
string in memory. In the example here, the function would find that 
the fun substring begins at memory location 4,000,003. 

But what if the strstr () can’t find the substring? What then? In 
that case, strstr () returns the value 0. Gan you think why that 
is? Well, if you remember, G treats zero as false. That means you 
can use strstr () to check for the existence of one string inside 
another, like this: 


char sO[] = "dysfunctional"; 
char s1[] = "fun"; 
if (strstr (sO, si)) 

puts ( n I found the fun in dysfunctional!"); 


Let’s see how we can use strstr() in the jukebox program. 



























out of the pool 



Paa] Puzzjc 


The guys in the Lounge had already started to write 

_ the code to search through the track list, but — 

yT oh no! — some of the paper they were writing 

、 the code on has fallen into the pool. Do you 

.. . think you can select the correct pieces of 

code to complete the search function? It's 
been a while since the pool was cleaned, so 
be warned: some of the code in the pool might 
not be needed for this program. 

Note: the guys have slipped in a couple of new 
pieces of code they found in a book somewhere. 


just rr»C3hS this -fuhdti 
woh't \rctu\rh a value. 


lOh 


void find track(char 



Hey, look ： youVc dv-catm^ a separate 灼 . 

Pv-csumably, v/V > ⑶ you avouy>d *to 
七 he rna'mO 七 ION I 七 Will dall 七 his. 


TWlS is i\\t w ^ov lo。?. 

]^t\\ look at *bWis m wove 一 
ac-ba»l m a y/W“c, Wt k 

y,OV/ YOU just 於 cd k ⑽ 

七七七 Mil *tK |S ? ,c ^ c 
of coAt *fwc 七 iwes. 


int i ; 
or (i 


f 


0; i < 5; i++) 

( 


printf("Track %i : '%s'\n' 


TW,s \s ▲代 VouVc -to 

starch *«S m tv-adk r>amc. 

/ l*f "the *tv*adk ouv* 

^ scav-dh, you II display i 七 hcv-c. 


)) 


VouVc go'mg -fco 
be pHhtmg out 
two values hcv-c. 


亇 

Or\t value Wi 
v\ttd bo fee 
dy\ m-tcyv-. 


II The o*thc\r v/ill 

be a s-tv-mg. 


Note: each thing from 
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strings 




BE • 

The jukebox program needs a main() 
function that reads ir^ut from tire user 
and calls tire ftnd_trac1^() function on the 
―」 一 ^ opposite page. Your job is to 

play like you ? re Ae compiler 
and say ^iieh of the 
following itiain() functions 
is tire one you need for tire 
jukebox program. 


int main() 

{ 

char search for[80]; 
printf ("Search for : ’▼); 
fgets(search—for, 80, stdin); 
find 一 track (); 
return 0; 


int main() 

{ 

char search for [ 80]; 
printf("Search for : n ) 
fgets(search—for, 79, 
find 一 track(search for) 
return 0; 


int main() 

{ 

char search for [ 80]; 
printf ("Search for : ’▼); 
fgets(search—for, 80, stdin); 
find 一 track(search for); 
return 0; 


int main() 

{ 

char search for[80]; 
printf ("Search for : n ) 
scanf(search for, 80, 
find_track(search for) 
return 0; 


stdin); 


stdin); 
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out of the pool 



puzz]c 

The guys in the Lounge had already started to 

write the code to search through the track list, 
but — oh no! — some of the paper they were 
writing the code on has fallen into the pool. 
You were to select the correct pieces of code 
to complete the search function. 


Note: the guys have slipped in a couple of new 
pieces of code they found in a book somewhere. 


void find—track(char search for []) 

{ 

int i ; 

for (i = 0; i < 5; i++) { 

if ( strstr ( tracks[i] ' search_for )) 

printf("Track %i: ' %s ' \n n , j , tracks[i] 
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strings 



BE • C 挪 巧1 改 §©]ug©n 

The jukebox program needs a main() 
function that reads ir^ut from tire user 
and calls tire find 一 trad() function on 

llie opposite pa^e. Your job 
was to play like you ? re tire 
compiler and say 
of tire following main() 
functions is tire one you 
need for tire jvkebox program. 



int main() 

{ 

char search for[80]; 
printf ("Search for : ’▼); 
fgets(search—for, 80, stdin); 

find—track 0 ； ^ ^ md >a6k() 

return 0; ta || c "d Wi*tV)ou*t ^ass'm^ 

} {\\t scav-tV> 七 evw. 


This vcv-sio^ isr/*t ihc 
-Pull o( 七 he av-v-ay. 

The dodev- has sub"tv*ad"tcd 
., ■ , 、 oy\c -Pvorw ihc Ic^aih, like 

int main() you would wilh suMl 

{ 

char search for[80]; 
printf ("Search for:，▼) 
fgets(search—for, 79, stdin); 
find_track(search for); 
return 0; 





"This is *thc 乙。 \r\red*t 
w^ihO -fuhdiioh. 


int main() 

{ 

char search for [ 80]; 
printf("Search for:"); 
fgets(search for, 80, stdin) 
find—track(search_for); 
return 0; 


TVlS VCV"S*IOir\ is us'mj 
s£.ar\-fO ar\d would allova 
{}\t iaSCV- *to cr\W ^1 

int main() ― 以 Ws 如 a 叫 . 

{ 

char search for[80]; 
printf("Search for: 
scanf(search—for, 80, stdin); 
find_track(search for); 
return 0; 
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code review 


Ifs time for a code review 


Let’s bring the code together and review what you’ve got so far: 


^ ^.IUee d to sid\oM U 如 4 #include < stdio . h > 
pv'mx-rO av>d sday>-r(/ -ru^tio^s. 


You II sei ihc i\radcs 針 ay, 
outside ih c aj 

+ihd_t^kO -Puh^tiohs ； thai 

way, ihc bracks will be usable 
cveirywhcirc -the 


#include <string.h> 




>u y/'ill also Y\ttd {\\t S*brm^h 
iicadcv*, so you scav-tV> 

-the s*tv-s*tv-0 -fuy>d*t*io^. 


This is youv v\tvi <f md 一 *bradk() - 

-fur\dtior\. You’ll v\ttd b> dtt\art *i*t 

\)trt bc-fovc you dall i 七 -fv-om mamO. 


TVis 匕 ode will display all 
the rr»atdliihg tv-a^ks. 


char tracks[][80] = { 

n I left my heart in Harvard Med School 
"Newark, Newark - a wonderful town ", 
"Dancing with a Dork", 

"From here to maternity", 

"The girl from Iwo Jima", 


void find track(char search for[]) 


i++ mea^s w *mdvcasc 
*tV>c value of *i by l w 


int i ; 

for (i = 0; i < 5; i++) { 

if (strstr(tracks[i], search for)) 

printf("Track %i : '%s'\n n , i, tracks[i]); 


f[v\A *tKis is youv m3m0 -fuy\t*tior \； - 

is 七 he stavtmj po*m*t o( ^ ^ 
*tV>C pvo^vam. 


int main() 

{ YouVc ask'm^ ^ov *tV>c 

char search—for [80] ; s cav^ ^cve- 

printf ("Search for : ’▼); 

fgets(search—for, 80, stdin); 

find 一 track (search for) ; Now you ddll youv new 

return 0 / ^ - f … ci 七 v*adkO 的匕七 iok> 

} display "the -tvadks. 


It’s important that you assemble the code in this order. The headers are 
included at the top so that the compiler will have all the correct functions 
before it compiles your code. Then you define the tracks before you write 
the functions. This is called putting the tracks array in global scope. 

A global variable is one that lives outside any particular function. Global 
variables like tracks are available to all of the functions in the program. 

Finally, you have the functions: f ind_track () first, followed by 
main () . The f ind_track () function needs to come first, before you 
call it from main (). 
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Tqst DriVQ 


It’s time to fire up the terminal and see if the code works. 


File Edit Window Help string. 


> gcc text_search.c -o text—search &&•/text 一 searc 
Search for : town 

Track 1: 'Newark , Newark - a wonderful town' 

> 


And the great news is, the program works! 

Even though this program is a little longer than any code you’ve 
written so far, it’s actually doing a lot more. It creates an array of 
strings and then uses the string library to search through all of 
them to find the music track that the user was looking for. 




rtcv, V>«y! TV^a-t Codt s a 
Wm ， suacss. tats m the 
bav- av-c ojroo^r! ov\ dovm a 








Gee| Bits 


For more information about the 
functions available in string.h, see 
h ttp://tinyurl. com/ 82 acwue. 

If you are using a Mac or a 
Linux machine, you can find out 
more about each of the string.h 
functions like strstr () by 
typing: 


man strstr 


you are here ► 
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no dumb questions 


ihereicire no o 

Dumb Questi9ns 


Why is the list of tracks defined 
as tracks [] [80] ? Why not 
tracks[5][80]? 

You could have defined it that way, 
but the compiler can tell there are five items 
in the list, so you can skip the [5] and 
just put []. 

But in that case, why couldn’t we 
just say tracks [] []? 

The track names are all different 
lengths, so you need to tell the compiler to 
allocate enough space for even the largest. 

Does that mean each string in the 
tracks array is 80 characters, then? 

The program will allocate 80 
characters for each string, even though 
each of them is much smaller. 


So the tracks array takes 80 x 
5 characters = 400 characters’ worth of 
space in memory? 

Yes. 

What happens if I forget to include 
a header file like sting.h7 

For some header files, the compiler 
will give you a warning and then include 
them anyway. For other header files, the 
compiler will simply give a compiler error. 

Why did we put the tracks 
array definition outside of the functions? 

We put it into global scope. Global 
variables can be used by all functions in the 
program. 


Now that we’ve created two 
functions, how does the computer know 
which one to run first? 

The program will always run the 
main () function first. 

Why do I have to put the 
find 一 track () function before 
main()? 

C needs to know what parameters a 
function takes and what its return type is 
before it can be called. 

What would happen if I put the 
functions in a different order? 

In that case, you’d just get a few 
warnings. 


BULLET POINTS - 

■ You can create an array of arrays with 

char strings[...][...]. 

■ The first set of brackets is used to access 
the outer array. 

■ The second set of brackets is used to 
access the details of each of the inner 
arrays. 


The string.h header file gives you access 
to a set of string manipulation functions in 
the C Standard Library. 

You can create several functions in a C 
program, but the computer will always run 
main ()first. 
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Code Magnets 


The guys are working on a new piece of code for a game. They’ve created a function 
that will display a string backward on the screen. Unfortunately, some of the fridge 
magnets have moved out of place. Do you think you can help them to reassemble 



the code? 


void print_reverse(char *s) 

sift is jus-t used { 匕 ~Tiiis v/ovks out of a 

s-fcov-ihg the siz^s thihy. - ^ size t len = strlen (s) ; so s*brlev\( w ABC ) 二二 

char = + - 1; 


while (. >= 

printf( n %c ", *t); 

t = 


puts (’▼’▼); 


0 


G3 

Q 


0 


0 


a 


0 


you are here ► 
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code magnets 


Code Magnets Solution 


The guys are working on a new piece of code for a game. They’ve created a function 
that will display a string backward on the screen. Unfortunately, some of the fridge 
magnets have moved out of place. You were to help them to reassemble the code. 



void print reverse(char *s 


size t len = strlen (s); 


char *t 


= 0 + Q 
0 0 ) 


- i 


while ( 

printf("%c n , *t); 


t 


t 


0 0 


匕 — * CaUulatm^ addv-csscs like 七 his 
called “fom 七伙 


puts (’▼’▼); 


Array of arrays vs. array of pointers 

You’ve seen how to use an array of arrays to store a 
sequence of strings, but another option is to use an array 
of pointers. An array of pointers is actually what it 
sounds like: a list of memory addresses stored in an array. 

It’s very useful if you want to quickly create a list of string 
literals: 


char *names_for_dog[] = {"Bowser ", "Bonza ", "Snodgrass"}; 

个 _ 一 h 个 f 

TWis is an av-v-ay Thcvc will be ohc foihtcv poihti% 

s*tov-cs fo"m*tcv-s. at stv-mg literal. 

You can access the array of pointers just like you accessed 
the array of arrays. 
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C-Cross 

Now that the guys have 
the print—reverse () 
function working, they Ve 
used it to create a 
crossword. The answers 
are displayed by the 
output lines in the code. 


Across 

int main() 





char *j uices[] = { 

'▼dragonf ruit n , "waterberry" , "sharonfruit" n uglifruit n , 
"rumberry" , "kiwif ruit" "mulberry" , "strawberry ", 
"blueberry", "blackberry", M starfruit" 


char *a; 

puts (juices[6]); 

print—reverse(juices[7]); 

a = juices[2]; 

juices[2] = juices[8]; 

juices[8] = a; 

puts(juices[8]); 

print reverse(juices[(18 




Down 



puts (juices [2]); 
print—reverse(j uices[9]); 
juices[1] = juices[3]; 
puts(juices[10]); 
print—reverse(j uices[1]); 
return 0; 


7)/5]) 


you are here ► 


99 








































crosswofc/ solved 



C-Cross 

Solution 

Now that the guys have 
the print—reverse () 
function working, they Ve 
used it to create a 
crossword. The answers 
are displayed by the 
output lines in the code. 


Across 

int main() 



char *juices[] = { 

’'dragonf ruit '，， n waterberry n , " sharonf ruit" , "uglif ruit ", 




n rumberry n , "kiwifruit ", 
"blueberry", "blackberry" 

}； 

char *a; 

puts (juices[6]); 
print—reverse(juices[7]); 
a = juices[2]; 
juices[2] = juices[8]; 
juices[8] = a; 
puts(juices[8]); 
print—reverse(juices[(18 + 


'mulberry ", "strawberry ", 
"starfruit" 




Down 



puts (juices[2]); 
print—reverse(juices[9]) 
juices [1] = juices[3]; 
puts (juices[10]); 
print—reverse(juices[1]) 
return 0; 


7) / 5]); 
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strings 



Your C Toolbox 


You’ve got Chapter 2.5 under 
your belt，and now you’ve 
added strings to your toolbox. 
For a complete list of tooltips in the 
book, see Appendix ii. 


TV^ 如 .— 


^ ^Irir^y 

is 

办 ^\ray ^ 
扣 mays. 


>u 


txt^t ^ 

a ， J a 叫 s 


stnr^ s ] 


si\rs£v-(a, b) 

will \rctu\rh *thc 
ddd\ress of 
s*t\rihj b ih s*t\rihj 


5 ^ m p0 

亡 。 spates 

士 W 。 ^ihJS. 


s 


a. 


s-t^KvO -f md 
i\\t lodatio^ 

a d^av-ad-tcv 
•mside a 


s*br6?Y() 

CO^\tS OY\t 

stvm^ *to 
a^o-bV^cv-. 


s\x^° , 

co^t^ 

w sV'^ s 


s 


s^lchO 
"P'^ds 1\)C 
of a 

stHhj. 


CHAPTER 2.5 
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3 creating small tQQh 

’Do one thing ♦ 

, and do it well ▲ 



Every operating system includes small tools. 

Small tools written in C perform specialized small tasks, such as reading and writing 
files, or filtering data. If you want to perform more complex tasks, you can even link 
several tools together. But how are these small tools built? In this chapter, you’ll look 
at the building blocks of creating small tools. You’ll learn how to control command-line 
options, how to manage streams of information, and redirection, getting tooled up in 
no time. 


this is a new chapter 
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tiny tools 


Small tools can solve big problems 

A small tool is a G program that does one task and does it well. 

It might display the contents of a file on the screen or list the 
processes running on the computer. Or it might display the first 
10 lines of a file or send it to the printer. Most operating systems 
come with a whole set of small tools that you can run from the 
command prompt or the terminal. Sometimes, when you have a 
big problem to solve, you can break it down into a series of small 
problems, and then write small tools for each of them. 


A small tool 
does one task 
and does it welL 

^ vicdU 一 small Ws. 


Someone’s written me a 
map web application, and I’d 
love to publish my route data 
with it. Trouble is, the format 
of the data coming from my 
GPS is wrong. 


TV^'is is da'ta \rom i\\t c^c\\s{!s 

^PS. IVs a tomw>a-scpara*tcd format 


This is a latitude. 

ic 


TWis is a lon^i-tudc- 


42.363400,-71.098465,Speed = 21 
42.363327,-71.097588,Speed = 23 
42.363255,-71.096710,Speed = 17 


O 




T\\t data’s ^ 
a IrbUc 



This is -the daia -the 

你外 heeds, (is ih JavaSdHpt 
Hoiaho^ ov- JSON. 


data=[ 

{latitude : 42.363400, 

longitude : 

-71.098465, 

info : 

'Speed = 

21 

{latitude : 42.363327, 

longitude : 

-71.097588, 

info : 

'Speed = 

23 

{latitude : 42.363255, 

longitude : 

-71.096710, 

info : 

'Speed = 

17 


If one small part of your program needs to 
convert data from one format to another, 
that’s the perfect kind of task for a small tool. 
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creating small tools 



?pc_ Cop® 


Hey, who hasn’t taken a code printout on a long ride only to find that it soon becomes... 
unreadable? Sure, we all have. But with a little thought, you should be able to piece together the 
original version of some code. 

This program can read comma-separated data from the command line and then display it in 
JSON format. See if you can figure out what the missing code is. 


^include <stdio.h> 

int main() 

{ 

float latitude; 

float longitude; 丁 ^ 匕 ^»q 

char inf o [ 80 ] ; 

int started = .; l/Vhat will these values y\uwbcv- o^ 

usmoy sta^O be? Rcmcmbcv -： sdah-fo values \i ^ able 

P uts(-data=[-); ^ 

while (scanf ( ，，％ f, %f, %79 [ A \n] n , . , . , .) == 3) { 

if (started) K This is lust a way of say-mj, ^ive r，e ev^y 

printf ( M , \n M ) ; dha\ra^tc\r up -fco the tv\A of the Ime.” 

else 

started = . ； Be davc^ul V^oy/ you set 

printf ( " {latitude : %f, longitude : %f, info : , %s , } n , .,.,. ); 

} 

puts ("\n]") ； values need *to be displayed? 

return 0; 

} 



you are here ► 
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pocket code 



VocKet cm 

§PLjitiPH 


Hey, who hasn’t taken a code printout on a long ride only to find that it soon becomes... 
unreadable? Sure, we all have. But with a little thought, you should have been able to piece 
together the original version of some code. 

This program can read comma-separated data from the command line and then display it in 
JSON format. You were to figure out what the missing code is. 


^include <stdio.h> 


int main() 


float latitude 


float long.tude; ^ ^ ^ b ^ m ^ set 

char info [80] ; ^ Q ) medns false. 


int started 


o 


puts( M data=["); 

while (scanf( n %f,%f,%79 


,n] ”， 


Did you \rcrwcmbc\r ihc oy\ ihc nurwbcv 
vaviablcs? sC^y\(0 needs pom 七 e\rs. 

翁 

flatitude f flo—*tude , 


3) 


if (started) display a Co^a ohly i-f you've 

printf ( n ,\n n ) ; already displayed a Previous lihe- 

else 一 ^ ^ -tv^c loof v^as started, you 

started =.; se 七 "to I, y/WiA .is *tv*uc* 

printf (" {latitude : %f, longitude : %f r info : ' % s ' } n A , ih-fo 


puts("\n]"); 
return 0; 


/ou do^i r\ttd { hcv-c bemuse 
p\rnvtPO is usihg the values, hoi 
"the ddd\resses o-f -the humbev-s. 
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creating small tools 



Tesr DriVq 



So what happens when you compile and run this code? What will it do? 

This is the data lha-ts pv-ih-tcd out TKis is da*ta you iypc *m 


File Edit Window Help JSON 


>./geo2json 
data=[ 



The ihput 3 hd the output 3 v*c mixed up. 


42.363400,-71.098465,Speed = 21 




^{latitude : 

42.363400, 

longitude : 

-71.098465, 

info : 

'Speed 

r 

{latitude : 

42.363327, 

longitude : 

-71.097588, 

info : 

'Speed 

r 

{latitude : 

r 

參•參 

42.363255, 

longitude : 

-71.096710, 

info : 

'Speed 

• •參 

• •參 

{latitude : 

42.363182, 

longitude : 

-71.095833, 

info : 

'Speed 

f 

{latitude : 

] 

> 

42.362385, 

longitude : 

-71.086182, 

info : 

'Speed 


'Speed = 21'}42•363327,-71•097588,Speed 
'Speed = 23'}42•363255,-71•096710,Speed 
▼ Speed = 17'}42•363182,-71•095833,Speed 


Several move houvs, y/o\rth o( -typmj... 


The program lets you enter GPS data at the keyboard and then it 
displays the JSON-formatted data on the screen. Problem is, the 
input and the output are all mixed up together. Also, there’s a lot of 
data. If you are writing a small tool, you don’t want to type in 
the data; you want to get large amounts of data by reading a file. 

Also, how is the JSON data going to be used? Surely it can’t be 
much use on the screen? 

So is the program running OK? Is it doing the right thing? Do 

you need to change the code? 


We really don't want the output 
on the screen. We need it in a file 
so we can use it with the mapping 
application. Here, let me show you... 


\y\ 


i\\t ty\A, you Y\ttd *to 
pvess C*tv*l—I) jus*t *to s*top 
fv-oyam- 



you are here ► 
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how it works 


Here's how the program should work 


O Take the GPS from the bike and download the data 

It creates a file called gpsdata.csv with one line of data for every 
location. 


This is the 6,pg Uhi 

usc ^ io brack -the 
loda-tioh -the bik 



diaia is downloaded 

•m*to *tWis -file- 


gpsdata.csv 


The geo2json tool needs to 
read the contents of the 
gpsdata.csv line by line... 


Reading this -file 


This is ou\r gcoZjsoh "tool. 


o 


..and then write that data in 
JSON format into a file called 
output.json. 


*th'is -f ile 


"tool will wviic 
-fco this -pile. 
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The web page that contains the map 
application reads the output.json file 

It displays all of the locations on the map. 


..… apflidation 

vedds i\\t data -fv-om 

ou*tpvA*tjsor\ 3ir\d disfUys i*t 
map rns'idc a web pay. 


outputjson 
























creating small tools 


Put youYe wot using files. 


The problem is, instead of reading and writing files, your program is 
currently reading data from the keyboard and writing it to the display. 

TV data is be，wad 


^ uv " "t°ol ^ohvcv-ts the data 

nvto the 


TV\c data »s scy>-b -to 
dis^laY ， y^oi *to a -f ile- 




But that isn’t good enough. The user won’t want to type in all 
of the data if it’s already stored in a file somewhere. And if the 
data inJSON format is just displayed on the screen, there’s no 
way the map within the web page will be able to read it. 

You need to make the program work with files. But how do 
you do that? If you want to use files instead of the keyboard 
and the display, what code will you have to change? Will you 
have to change any code at all? 





Is there a way of making our program 
use files without changing code? 
Without even recompiling it? 




Gee} Bits 


Tools that read data line by line, process 
it, and write it out again are called 
filters. If you have a Unix machine, or 
you’ve installed Cygwin on Windows, you 
already have a few filter tools installed. 

head: This tool displays the first few lines 
of a file. 

taihThis filter displays the lines at the 
end of a file. 

sed: The stream editor lets you do things 
like search and replace text. 

You’ll see later how to combine filters 
together to form filter chains. 


you are here ► 
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redirect data 


You can use redirection 


You’re using scanf () and printf () to read from the 
keyboard and write to the display. But the truth is, they don’t 
talk directly to the keyboard and display. Instead, they use the 

Standard Input and Standard Output. The Standard Input 
and Standard Output are created by the operating system when the 
program runs. 



T"hc pvogvam outputs data 
though -the S-bhdav-d Output 


The operating system controls how data gets into and out of 
the Standard Input and Output. If you run a program from the 
command prompt or terminal, the operating system will send all 
of the keystrokes from the keyboard into the Standard Input. If 
the operating system reads any data from the Standard Output, 
by default it will send that data to the display. 

The scanf () and printf () functions don’t know, or care, 
where the data comes from or goes to. They just read and write 
Standard Input and the Standard Output. 

Now this might sound like it’s kind of complicated. After all, why 
not just have your program talk directly to the keyboard and 
screen? Wouldn’t that be simpler? 

Well, there’s a very good reason why operating systems 
communicate with programs using the Standard Input and the 
Standard Output: 

You can redirect the Standard Input and 
Standard Output so that they read and write 
data somewhere else, such as to and from files. 
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creating small tools 


You caw redirect the Standard Input with <... 

Instead of entering data at the keyboard, you can use the < 
operator to read the data from a file. 


42.363400,-71 

42.363327,-71 

42.363255,-71 

42.363182,-71 

42.363110,-71 

42.363037,-71 

42.362965,-71 

42.362892,-71 

42.362820,-71 

42.362747,-71 

42.362675,-71 

42.362602,-71 

42.362530,-71 

42.362457,-71 

42.362385,-71 


098465,Speed = 21 
097588,Speed = 23 
096710,Speed = 17 
095833,Speed = 22 
094955,Speed = 14 
094078,Speed = 16 
093201,Speed = 18 
092323,Speed = 22 
091446,Speed = 17 
090569,Speed = 23 
089691,Speed = 14 
088814,Speed = 19 
087936,Speed = 16 
087059,Speed = 16 
086182,Speed = 21 


Tiiis is -file 

-fvom device* 


This is telling the opev-atmg 
"to s^hd "the dd'td 

the -Pile ih-to the 

Ihfut o-P the p\rogv-«lrw. 



You (WUavc k 切 d 

^PS data, so you doyv i see »t 

nx\%td ou-tfut- 


File Edit Window Help Don’tCrossTheStreams 


> ./geo2json < gpsdata.csv 
data=[ 




{latitude : 

42.363400, 

longitude : 

-71.098465, 

info : 

'Speed = 

21，}, 



{latitude : 

42.363327, 

longitude : 

- 71.097588, 

info : 

'Speed = 

23], 


,ou \us*t sec 七 
ddxd 

{latitude : 

42.363255, 

longitude : 

-71.096710, 

info : 

'Speed = 

17], 

Moyj ) 

JSON 

{latitude : 

42.363182, 

longitude : 

-71.095833, 

info : 

'Speed = 

22，}, 

{latitude : 

42.363110, 

longitude : 

-71.094955, 

info : 

'Speed = 

14], 

{latitude : 

42.363037, 

longitude : 

-71.094078, 

info : 

'Speed = 

16], 

士 Vom 

*thc pvoyam. 

參 • • 







參 • • 

{latitude : 

42.362385, 

longitude : 

-71.086182, 

info : 

'Speed = 

21' } 


The < operator tells the operating system that the 
Standard Input of the program should be connected 
to the gpsdata.csv file instead of the keyboard. So you 
can send the program data from a file. Now you just 
need to redirect its output. 



you are here ► 
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redirect output 


• •• 


awd redirect the Standard Output with > 


To redirect the Standard Output to a file, you need to use the > operator: 


Noy/ you av-c vediv-ettm^ 
S-ta^dav-d ar>d 
S*tar\davd Output 



TV output <^f the will 

be wiri-t-tch -to output isoh. 

I 


how 


TV^CV"C s r\o ou*bfVA*t 

oy^^c a*«sfla7 a-t all; 
vt’s all y>v\t *to *bV^c 

ou-tfu-t jsoy^ Ale. 


data=[ 

{latitude 
{latitude 
{latitude 
{latitude 
{latitude 
{latitude 
{latitude 
{latitude 
{latitude 
{latitude 
{latitude 
{latitude 
{latitude 
{latitude 
{latitude 


42.363400, 

42.363327, 

42.363255, 

42.363182, 

42.363110, 

42.363037, 

42.362965, 

42.362892, 

42.362820, 

42.362747, 

42.362675, 

42.362602, 

42.362530, 

42.362457, 

42.362385, 


longitude 

longitude 

longitude 

longitude 

longitude 

longitude 

longitude 

longitude 

longitude 

longitude 

longitude 

longitude 

longitude 

longitude 

longitude 


-71.098465, 

info 

'Speed 

= 

21 ▼ } 

-71.097588, 

info 

'Speed 

= 

23, } 

-71.096710, 

info 

'Speed 

= 

17 ， } 

-71.095833, 

info 

'Speed 

= 

22 ， } 

-71.094955, 

info 

'Speed 

= 

14 ' } 

-71.094078, 

info 

'Speed 

= 

16, } 

-71.093201, 

info 

'Speed 

= 

18 ， } 

-71.092323, 

info 

'Speed 

= 

22 ， } 

-71.091446, 

info 

'Speed 

= 

17 ， } 

-71.090569, 

info 

'Speed 

= 

23, } 

-71.089691, 

info 

'Speed 

= 

14 ' } 

-71.088814, 

info 

'Speed 

= 

19, } 

-71.087936, 

info 

'Speed 

= 

16, } 

-71.087059, 

info 

'Speed 

= 

16, } 

-71.086182, 

info 

'Speed 

= 

21 ， } 


Because you’ve redirected the Standard Output, you 
don’t see any data appearing on the screen at all. But the 
program has now created a file called output.json. 

The output.json file is the one you needed to create for the 
mapping application. Let’s see if it works. 




outputjson 





outputjson 
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creating small tools 



Tesr DriVq 


Now it’s time to see if the new data file you’ve created can be used 
to plot the location data on a map. You’ll take a copy of the web 
page containing the mapping program and put it into the same 
folder as the output.json file. Then you need to open the web page 
in a browser: 



The map works. 

The map inside the web page is able to read the data from the 
output file. 



Da this! 


Download the web page from 
h ttp://oreillyhfc. appspot. com/map.html. 



gpsapp 


map.html 


TVis is 如 
web pay 

tor\*ta'ms 州外 . 



(c ： 一 ^ This is the -file 
"that ou\r 


outputjson 


















































bad data 


Put there's a problem with some of the data 

Your program seems to be able to read GPS data and format it 
correctly for the mapping application. But after a few days, a 
problem creeps in. 



Invalid latitude: '423.631805' 


So what happened here? The problem is that there was some bad 
data in the GPS data file: 


{latitude : 42.363255, longitude : -71.096710, info : 'Speed = 17'}, 
{latitude : 423.63182 , longitude : -71.095833, info : 'Speed = 22'}, 


~ 一 



"Hie dcdirwal po'mi is m the plade m 七 his humbev'. 


But the geo2 j son program doesn’t do any checking of the data it 
reads; it just reformats the numbers and sends them to the output. 


That should be easy to fix. You need to validate 
the data. 
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creating small tools 



You need to add some code to the geo2 j son program that will check for bad latitude and 
longitude values. You don’t need anything fancy. If a latitude or longitude falls outside the 
expected numeric, just display an error message and exit the program with an error status of 2: 


^include <stdio.h> 


int main() 

{ 

float latitude; 
float longitude; 
char info[80]; 
int started = 0; 


puts( n data=["); 

while (scanf ( n %f,%f,%79[A\n] n , &latitude 
if (started) 
printf (▼', \n n ); 
else 

started = 1; 


&longitude, info) == 3) { 


|*f 七 he latitude is < AO o\r > error 

v/rtii s*ta 七 us i. 七 he 1。— 七 ude is < - 1 召 O ov 
> I GO, *tKcir> cvvov Vi 七 h status Z. 


printf("{latitude : %f, longitude : %f, info : , %s , } n , latitude, longitude, info); 

} 

puts("\n]"); 
return 0; 


you are here ► 


115 















lat long 



You needed to add some code to the geo2json program to check for bad latitude and 
longitude values. If a latitude or longitude falls outside the expected numeric, just display an 
error 


message and exit the program with an error status of 2: 


^include <stdio.h> 


int main() 

{ 

float latitude; 
float longitude; 
char info[80]; 
int started = 0; 


puts( n data=["); 

while (scanf( n %f,%f,%79[ A \n] n , &latitude, &longitude, info) == 3) { 

if (started) 
printf (▼', \n n ); 
else 



started 


. i-f ((latitude .< rr^Q.Q). )1 .(kiiiudc > ^O.O)) { 

.. — > return Z ； 


i-f (0or\ji*tudc < —I0O.O) II Oor\ji*tudc > 180.0)) { 
prm*tf( w |rwalid lor^rtude: loh^i-tudc )； 

vc*tu\rh Z ； 



Tksc Imcs dhedk ihai -the 
latitude 3hd loh^i'tudc 3V"C 
the 6o\r\rc6i \rah^e. 


TV^SC Ues d 、 s—7 
simple trcox mcssaf 


printf("{latitude : %f, longitude : %f, info : , %s , } n , latitude, longitude, info); 

} 

puts("\n]"); 
return 0; 
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creating small tools 



Tqst DriVq 


OK, so you now have the code in place to check that the latitude and 
longitude are in range. But will it be enough to make our program cope 
with bad data? Let’s see. 


Compile the code and then run the bad data through the program: 



jcc geo2json.c -o geo2json 
•/geo2json < gpsdata.csv > output 


This lihc will 代 匕 ompil 


Hmmm.. .that’s odd. You added the 
error-checking code, but when you 
run the program, nothing appears to be 
different. But now no points appear on 
the map at all. What gives? 


You’ll save 

*m i\\t 灼 -f ile- 


TV\cy\ r\AY\ 


^TF??? /Vo 

cv-\rov- message? 


TV^is 

'Welcome To 


A o 


Geo-locater 


Map I Satellite 

W^jM M Show latx>ls 


Pocchu 


Kingdom Polska 


Canada 


y/V\cv-c did a" 

i\\c fo'nrrb 50? 


United 

Stat6S 


North 

Atlantic 

Ocean 


‘，中.『」 


r/3urlt3Mi3 


Indonesia 




Madagascar 


Soiitfi 

Atlantic 

Ocean 


Southern 


Google search the map 


Search 





Study the code. What do you think happened? Is the code doing what you asked 
it to? Why weren’t there any error messages? Why did the mapping program think 
that the entire output.json file was corrupt? 
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code deconstruction 


CODli ： DKCONSTRIJCTION 


The mapping program is complaining about the output.json file, so let’s open it up and see what’s 

inside: -r» _ •_ u_ 丄内 .. 丄 S^\\ t . 


Tiiis is ou*tfu*t jsor> 


data=[ 







{latitude : 

42.363400, 

longitude : 

-71.098465, 

info : 

'Speed = 

21，}, 

{latitude : 

42.363327, 

longitude : 

-71.097588, 

info : 

'Speed = 

23，}, 

{latitude : 

42.363255, 

longitude : 

-71.096710, 

info : 

'Speed = 

17，}, 

Invalid latitude : 423 

• 631805 






0 \\) 七 he cv-\ro\r message was also v-cdiv-cd-tcd *fco 七 he output -Pile. 



Once you open the file, you can see exactly what happened. The program saw that there 
was a problem with some of the data, and it exited right away. It didn’t process any more 
data and it did output an error message. Problem is, because you were redirecting the 
Standard Output into the output json, that meant you were also redirecting the error 
message. So the program ended silently, and you never saw what the problem was. 

Now, you could have checked the exit status of the program, but you really want to be able 
to see the error messages. 


But how can you still display error messages if you are redirecting 
the output? 



Gee| B 形 


If your program finds a problem in the data, it exits with a status of 2. But how can you check 
that error status after the program has finished? Well, it depends on what operating system 
you’re using. If you’re running on a Mac, Linux, some other kind of Unix machine, or if you’re 
using Cygwin on a Windows machine, you can display the error status like this: 



If you’re using the Command Prompt in Windows, then it’s a little different: 


File Edit Window Help 


C:\> echo %ERRORLEVEL% 
2 


Both commands do the same thing: they display the number returned by the program when it 
finished. 
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creating small tools 



WouldtVt it be dreamy if there 
were a special output for errors so 
that I didiVt have to mix my errors 
in with Standard Output? But I know 
ifs just a fantasy... 
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standard error 


Introducmg the Standard Error 

The Standard Output is the default way of outputting data 
from a program. But what if something exceptional happens, like 
an error? You’ll probably want to deal with things like error 
messages a little differently from the usual output. 

That’s why the Standard Error was invented. The Standard 
Error is a second output that was created for sending error messages. 

Human beings generally have two ears and one mouth, but 
processes are wired a little differently. Every process has one ear 
(the Standard Input) and two mouths (the Standard Output 
and the Standard Error). 


Human 

TVis is ohc cav. — ^ 



TWis »s av^cv cayr . 
Sihgle mouih. Multiple 


uses. 


Process 



Let’s see how the operating system sets 
these up. 
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creating small tools 


Py default the Standard Error is sewt 
to the display 


Remember how when a new process is created, the operating 
system points the Standard Input at the keyboard and the Standard 
Output at the screen? Well, the operating system creates the 
Standard Error at the same time and, like the Standard Output, the 
Standard Error is sent to the display by default. 


/hpu-t ^or^es 

"the keyboard. 


^*tolhd3\rd Bv\ro\r 
goes -to the display 












⑹ (((((((({(((uuuuiuunm ⑴川】⑴ ) 1 ) 价 ⑴ )) 





Sta^dav-d 

^ocs *to *tV^c display* 


That means that if someone redirects the Standard Input and 
Standard Output so they use files, the Standard Error will continue 
to send data to the display. 


S-tahdaird —^ prN 

/hpirt 

舂咖 a (i| e . l~j 



And that’s really cool, because it means that even if the Standard 
Output is redirected somewhere else, by default, any messages 
sent down the Standard Error will still be visible on the 
screen. 

So you can fix the problem of our hidden error messages by simply 
displaying them on the Standard Error. 


But how do you do that? 
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fprintfQ 


fpriwtfO prints to a data stream 

You’ve already seen that the printf () function sends 
data to the Standard Output. What you didn，t know is that 
the printf () function is just a version of a more general 
function called fprintf () : 

)； 

\ These two dalls av-c c^uivalc^t 

r 

Turtles ! ’▼); 

、丁 his is the daia that will be 

SCh-fc. 




'you 63^1 

attvAalW 乙 alU 
灼七 ((). 



printf ( 11 1 like Turtles ! 


This will scy\d data -to 
"the daia si\rcarw. 


fprintf(stdout, "I like 

? , 
stdou-t «S i\\t Standard 

Ou 七 ? u 七 data stream. 


The fprintf () function allows you to choose where you 
want to send text to. You can tell fprintf () to send text 
to stdout (the Standard Output) or stderr (the Standard 
Error). 


there ^ are no o 

Dumb Questi9ns 


There’s a stdout and a stderr. Is there a stdin? 


Yes, and as you probably guessed, it refers to the Standard 

Input. 


Can I print to it? 


No, the Standard Input can’t be printed to. 


Can I read from it? 


Yes, by using f scanf (), which is just like scanf (), 
but you can specify the data stream. 


So is f scanf (stdin, . . .) exactly the same as 
scanf(...)? 

Yes, they’re identical. In fact, behind the scenes, 

scanf (...) just calls f scanf (stdin,...). 


Can I redirect the Standard Error? 


Yes; > redirects the Standard Output. But 2 > redirects the 
Standard Error. 


So I could write geo2 json 2> errors . txt? 

Yes. 
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creating small tools 


Let’s update the code to use fpriwtfO 

With just a couple of small changes, you can get our error 
messages printing on the Standard Error. 



That means that the code should now work in exactly the same 
way, except the error messages should appear on the Standard 
Error instead of the Standard Output. 


Let’s run the code and see. 
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test drive 



Tqst DriVQ 


If you recompile the program and then run the corrupted GPS 
data through it again, this happens. 


I File Edit Window Hein ControlErrorR_I 


> gcc geo2json.c -o geo2json 

> ./geo2json-page21 < gpsdata.csv > output.j son 
Invalid latitude : 423.631805 


That’s excellent. This time, even though you are redirecting 
the Standard Output into the output json file, the error message 
is still visible on the screen. 

The Standard Error was created with exactly this in mind: 
to separate the error messages from the usual output. But 
remember: stderr and stdout are both just output 
streams. And there’s nothing to prevent you from using them 
for anything. 

Let’s try out your newfound Standard Input 
and Standard Error skills. 


BULLET POINTS - 

■ The printf () function sends data to 
the Standard Output. 

■ The Standard Output goes to the display 
by default. 

■ You can redirect the Standard Output to a 
file by using > on the command line. 

■ scanf () reads data from the Standard 
Input. 

■ The Standard Input reads data from the 
keyboard by default. 

■ You can redirect the Standard Input to read 
a file by using < on the command line. 

■ The Standard Error is reserved for 
outputting error messages. 

■ You can redirect the Standard Error using 
2 >_ 
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creating small tools 


TOP SECRET 

We have reason to believe that the following program has been used in the transmission of secret messages: 

^include <stdio.h> 


int main() 

{ 

char word[10]; 

int i = 0; 

while (scanf ( ，，％ 9s n , 

•i % W TKc n 

remd'mder Irf 七 ⑶ 


fprintf(stderr. 




if (i % 2) 

fprintf(stdout, 
else 


word) — 1) { 

n %s\n n , word); 
n %s\n n , word); 


return 0; 


We have intercepted a file called secret.txt and a scrap of paper with instructions: 


THE BUY SUBMARINE 
SIX WILL EGGS 
SURFACE AND AT 
SOME NINE MILK PM 


K,un lorth: 

secret 一 messages < secrei.*b<*i ： > nnessagel.*b<*i ： 3l> nnessage«9l.*b<i 





> 


will \rcdi\rc^-t the Stared Ou-tfut 2> Will rtAWtd S-ta^dav-d Brror. 


Your mission is to decode the two secret messages. Write your answers below. 

Message 1 Message 2 
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top secret solved 


TOP SECRET — SOLVED 

We have reason to believe that the following program has been used in the transmission of secret messages: 

^include <stdio.h> 

int main() 

{ 

char word[10]; 
int i = 0; 

while (scanf ( ，，％ 9s n , word) == 1) { 

i = i + 1 ; 
if (i % 2) 

fprintf(stdout, "%s\n n , word); 
else 

fprintf (stderr, ， ' ％ s\n n , word); 

} 

return 0; 


We have intercepted a file called secret.txt and a scrap of paper with instructions: 



Your mission was to decode the two secret messages. 


Message 1 

Message 2 

THE 

Buy 

SUBMARINE 

S|>< 

WILL 

E 私 S 

SURFACE 

m 

AT 

S_E 

NINE 

yi/iILK 
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creating small tools 



The System Ex^osedi 


This week’s interview: 

Does the Operating System Matter? 


Head First： Operating System, we’re so pleased 
you’ve found time for us today. 

O/S： Time sharing: it’s what I’m good at. 

Head First： Now you’ve agreed to appear under 
conditions of anonymity, is that right? 

O/S： Don’t Ask/Don’t Tell. Just call me O/S. 

Head First： Does it matter what kind of O/S you 
are? 

O/S： A lot of people get pretty heated over which 
operating system to use. But for simple G programs, 
we all behave pretty much the same way. 

Head First： Because of the G Standard Library? 

O/S： Yeah, if you’re writing G, then the basics are 
the same everywhere. Like I always say, we’re all the 
same with the lights out. Know what I’m saying? 

Head First： Oh, of course. Now, you are in charge 
of loading programs into memory? 

O/S: I turn them into processes, that’s right. 

Head First： Important job? 

O/S： I like to think so. You can’t just throw a 
program into memory and let it struggle, you know? 
There’s a whole bunch of setup. I need to allocate 
memory for the programs and connect them to their 
standard data streams so they can use things like 
displays and keyboards. 

Head First： Like you just did for the geo2 j son 
program? 

O/S: That guy ’s a real tool. 

Head First: Oh, Fm sorry. 

O/S: No, I mean he’s a real tool: a simple, text-based 
program. 


Head First： Ah, I see. And do you deal with a lot 
of tools? 

O/S: Ain’t that life? It depends on the operating 
system. Unix-style systems use a lot of tools to get the 
work done. Windows uses them less, but they’re still 
important. 

Head First： Creating small tools that work together 
is almost a philosophy, isn’t it? 

O/S: It’S a way of life. Sometimes when you’ve got a 
big problem to solve, it can be easier to break it down 
into a set of simpler tasks. 

Head First: Then write a tool for each task? 

O/S: Exactly. Then use the operating system — that’s 
me — to connect the tools together. 

Head First： Are there any advantages to that 
approach? 

O/S: The big one is simplicity. If you have a set of 
small programs, they are easier to test. The other 
thing is that once you’ve built a tool, you can use it in 
other projects. 

Head First： Any downsides? 

O/S: Well, tools don’t look that great. They work on 
the command line usually, so they don’t have a lot of 
what you might call Eye Appeal. 

Head First： Does that matter? 

O/S: Not as much as you’d think. As long as you 
have a set of solid tools to do the important work, 
you can always connect them to a nice interface, 
whether it’s a desktop application or a website. But, 
hey, look at the time. Sorry, I’ve got to preempt you. 

Head First： Oh, well, thank you, O/S; it’s been a 
pleas … 议 d. 
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Small tools are flexible 


One of the great things about small tools is their flexibility. If you 
write a program that does one thing really well, chances are you will 
be able to use it in lots of contexts. If you create a program that can 
search for text inside a file, say, then chances are you going to find 
that program useful in more than one place. 

For example, think about your geo2 j son tool. You created it to 
help display cycling data, right? But there’s no reason you can’t use it 
for some other purpose...like investigating...the … 



TVlis is lo\r\^'i*tudc -? 厶 . 


Tiiis is lo^jitudc 一 & 十 . 


This is 

latitude ? 午 。. 


This is 

latitude Z 厶 0 . 


To see how flexible our tool is, let’s use it for a completely different 
problem. Instead of just displaying data on a map, let’s try to use 
it for something a little more complex. Say you want to read in a 
whole set of GPS data like before, but instead of just displaying 
everything, let’s just display the information that falls inside the 
Bermuda Rectangle. 

That means you will display only data that matches these conditions: 

((latitude > 26) && (latitude < 34)) 


((longitude > -76) && (longitude < -64)) 


So where do you need to begin? 
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creating small tools 


Pow't change the geoZjson tool 

Our geo2 j son tool displays all of the data it’s given. So what 
should we do? Should we modijy geo2 j son so that it exports 
data and also checks the data? 

Well, we could, but remember, a small tool: 

does one job and does it well 


You don’t really want to modify the geo2 j son tool, because 
you want it to do just one task. If you make the program do 
something more complex, you’ll cause problems for your users 
who expect the tool to keep working in exactly the same way. 




Tips Designing Small T 弱 Is 


They can read data from the Standard Input. 


I really don’t want 
to filter data. I need 
to keep on displaying 
everything. 


So if you don’t want to change the 
geo2json tool, what should you do? 


Small tools like geo2 j son all follow these design principles: 


* They can display data on the Standard Output. 


* They deal with text data rather than obscure binary formats. 


* They each perform one simple task. 
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two tools 


A different task needs a different tool 

If you want to skip over the data that falls outside the Bermuda 
Rectangle, you should build a separate tool that does just that. 

So, you’ll have two tools: a new bermuda tool that filters out 
data that is outside the Bermuda Rectangle, and then your 
original geo2 j son tool that will convert the remaining data 
for the map. 

This is how you’ll connect the programs together: 






-** you’ll -feed sll 

m*to *tV)C bc\rw>uda "tool- 

$ 丁 his data i^ludcs events ihside a^d 

outside the Bcv-muda Rcdta^glc. 


The "tool v/ill oy>ly pass oy> 七 1^3 七 

t *tV>C Bermuda Rcd*t3ir>^lc- 



m ^-So you will only pass Bermuda 

> Rctta^lc data -to gcoZjsor>. 


^Co2-jsoy\ y/ill wo\rk 
■bV^c same as bc-fo\rc- 


By splitting the problem down into two tasks, you will be able 
to leave your geo2 j son untouched. That will mean that its 
current users will still be able to use it. The question is: 

How will you connect your two tools together? 


You Vill pv-odude a map 

dor\*tam'nr \5 or\ly BcV"w\ud 3 

da*t3- 
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creating small tools 


Cowwcct your input awd output with a pipe 

You’ve already seen how to use redirection to connect the 
Standard Input and the Standard Output of a program file. But 
now you’ll connect the Standard Output of the bermuda 
tool to the Standard Input of the geo2 json, like this: 



Tke I symbol is a 
pipe tkat connects 
tke StanctarJ Output 
oi one process to tke 
Stanctarct Input ol 
anotker process. 


output bc\rrwuda... 


pipe be used *to *thc / 

£tay>diav-d u*t o( or>c f\rodcss b> 
Sia^davd o-f air>o*tV>cv fvodcss. 


This is a pipe. 


...Ws •…* to J — 产 


That way, whenever the bermuda tool sees a piece 
of data inside the Bermuda Rectangle, it will send the data 
to its Standard Output. The pipe will send that data from 
the Standard Output of the bermuda tool to Standard 
Input of the geo2 j son tool. 

The operating system will handle the details of exactly how 
the pipe will do this. All you have to do to get things running 
is issue a command like this: 

The opematmg . Tii'is is fife- 

systcrw will v-uh _ _ , _ . 

both P ,o 9 ^sat^ bermuda 1 g eo2 ] son 

tKc same lime. ^Thc output O-P bc^uda will bedome the \^i <^f gcoZjsoh. 




So now it’s time to build the bermuda tool. 
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tool notes 


The bermuda tool 

The bermuda tool will work in a very similar way to the 
geo2 j son tool: it will read through a set of GPS data, line by 
line, and then send data to the Standard Output. 

But there will be two big differences. First, it won’t send every 
piece of data to the Standard Output, just the lines that are 
inside the Bermuda Rectangle. The second difference is that 
the bermuda tool will always output data in the same CSV 
format used to store GPS data. 

This is what the pseudocode for the tool looks like: 


:::::: r 

^ h ^on 3rtude(S 

-“⑽-為^ 

ihe ia| liude ^ 

’叫 and 0 扑 e 「 d 抽 


Let’s turn the pseudocode into C. 
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creating small tools 


Paa] Puzzjc 

Your goal is to complete the code for 
the bermuda program. Take code 
snippets from the pool and place 
them into the blank lines below. 
You won’t need to use all the 
snippets of code in the pool. 


#include <stdio.h> 



int main() 

{ 

float latitude; 
float longitude; 
char info[80]; 

while (scanf( n %f,%f,%79[A\ n ] n , , , ) == 3) 

if ((. > .).(.<.)) 

if … （ 〈 … ） 

printf( n %f , %f , %s\n n , , , ); 


return 0; 


Note: each thing from 
the pool can be used 
only once! 
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out of the pool 


Paa] puzzjc 

Your goal was to complete the code for 
the bermuda program by taking 
code snippets from the pool and 
placing them into the blank lines 
below. 


#include <stdio.h> 

int main() 

{ 

float latitude; 
float longitude; 
char info[80]; 

while (scanf ( n %f, %f, %79 [ A \n] ", platitude..... , ^^longitude.. . .) == 3) 

if ((… latitude. > .26. ) . && . ( .latitude < .34. )) 

if ( ( longitude > -76 ) && ( longitude < : 64 )) 

printf ( n %f,%f,%s\n n , latitude r longitude r info )； 

return 0; 



Note: each thing from 
the pool can be used 
only once! 
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creating small tools 



Tqst DriVq 


Now that you’ve completed the bermuda tool, it’s time to 
use it with the geo2 j son tool and see if you can map any 
weird occurrences inside the Bermuda Rectangle. 

Once you’ve compiled both of the tools, you can fire up a 
console and then run the two programs together like this: 



You can download the spooky.csv f\\e at 
h ttp://oreillyhfc. appspot. com/spooky, csv. 




TV^'is *»s i\\t pifc 

fv-odcsscs. 


Tills IS 


Rcrwcrnbcv*- i-f you 3\rc v*urmmg o 的 

ldow”ou do^-t ,eed the V" the ? ro«sscs. ^ 

W\\tY\ you toY\Y\ttx u (. /bermuda | . /geo2 json) < spooky .csv > output.json 

,—- - ^ \ 


-flic all events. 


"ty/o ^\ro^v*3w>s 

you c^v\ *brea 七 as \ \ „ 丄 

" 咖 . bc ， r T da Ul d 。乂 to ^ 

D events wc wah-t -to 咖。代 . events *to JSON W 你 at. 


I/Vcll save the 

ou-tpu-t ih -this -file. 


By connecting the two programs together with a pipe, you 
can treat these two separate programs as if they were a 
single program, so you can redirect the Standard Input and 
Standard Output like you did before. 



./bermuda | ./geo2json) < spooky.csv > output.j son 


Excellent: the 
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program 






Havana 


Turlcs and 
Cakcos Islands 


Cancun 


Merida ^ 
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- Bayartio- J • < <* 


Raya del 
Carmen 


Santiago 
De Cuba 
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Islands 


British Vlf{ 
Islands 


Google 

jHHMueais 


search the 
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no dumb questions 


tWeiare no o 

Dumb Questions 


Why is it important that small 
tools use the Standard Input and 
Standard Output? 

Because it makes it easier to connect 
tools together with pipes. 

Why does that matter? 

Small tools usually don’t solve an 
entire problem on their own, just a small 
technical problem, like converting data 
from one format to another. But if you can 
combine them together, then you can solve 
large problems. 

What is a pipe, actually? 

The exact details depend on the 
operating system. Pipes might be made 
from sections of memory or temporary files. 
The important thing is that they accept data 
in one end, and send the data out of the 
other in sequence. 


So if two programs are piped 
together, does the first program have 
to finish running before the second 
program can start? 

No. Both of the programs will run at 
the same time; as output is produced by 
the first program, it can be consumed by 
the second program. 

Why do small tools use text? 

It's the most open format. If a 
small tool uses text, it means that any 
other programmer can easily read and 
understand the output just by using a text 
editor. Binary formats are normally obscure 
and hard to understand. 

Can I connect several programs 
together with pipes? 

Yes, just add more | between each 
program name. A series of connected 
processes is called a pipeline. 


If several processes are 
connected together with pipes and then 
I use > and < to redirect the Standard 
Input and Output, which processes will 
have their input and output redirected? 

The < will send a file’s contents to 
the first process in the pipeline. The > will 
capture the Standard Output from the last 
process in the pipeline. 

Are the parentheses really 
necessary when I run the bermuda 
program with geo2 json? 

Yes. The parentheses will make sure 
the data file is read by the Standard Input 
of the bermuda program. 


BULLET POINTS 一 

■ If you want to perform a different 
task, consider writing a separate 
small tool. 

■ Design tools to work with Standard 
Input and Standard Output. 


■ Small tools normally read and write 
text data. 

■ You can connect the Standard 
Output of one process to the 
Standard Input of another process 
using a pipe. 
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Put what if you wawt to output to 
more thaw owe file? 

We’ve looked at how to read data from one file and write to 
another file using redirection, but what if the program needs 
to do something a little more complex, like send data to 

more than one file? 

Imagine you need to create another tool that will read a set 
of data from a file, and then split it into other files. 




PooP !， 





QJj ((((((((((((((((( ⑴ n 川川 j ) 1 


spooky.csv 




iim ⑴⑴⑴ ))u))))))))))))@D 





poopr 


disappearances.csv 


So what’s the problem? You can’t write to files, right? 
Trouble is, with redirection you can write to only two files 
at most, one from the Standard Output and one from the 
Standard Error. So what do you do? 



other.csv 
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data streams on the fly 


Roll your own data streams 

When a program runs, the operating system gives it three file 
data streams: the Standard Input, the Standard Output, and the 
Standard Error. But sometimes you need to create other data 
streams on the fly. 

The good news is that the operating system doesn’t limit you to the 
ones you are dealt when the program starts. You can roll your own 
as the program runs. 

Each data stream is represented by a pointer to a file, and you can 
create a new data stream using the f open () function: 



This will a T^*»s »s d 如 Ale. 

daia s-tv-ca^ -to Si 

vead a FILE * in — file = fopen("input.txt' 


■This is -the r^odc-* mcahs 


r"); 


This is tk <^P -the -file. 

TWis y/ill dV"C3*tc 3 

s 七 ream *to ^ FILE *out_file = fopen ("output. txt", 
y/vitc *bo 9 


TWis is i\\t mode: V’ means 'w 


w") 


The f open () function takes two parameters: a filename and a 
mode. The mode can be w to write to a file, r to read from a file, or 
a to append data to the end of a file. 


Once you’ve created a data stream, you can print to it using 
fprintf (), just like before. But what if you need to read from a 
file? Well, there’s also an fscanf () function to help you do that 
too: 


Tke mode is: 


ff ，， 

w 


write ， 
react, or 
” a” = append. 


代 ” 一 

r = 


fprintf(out file, "Don't wear %s with %s ", "red ", "green"); 


fscanf(in file, "%79[ A \n]\n n , sentence); 


Finally, when you’re finished with a data stream, you need to close 
it. The truth is that all data streams are automatically closed when 
the program ends, but it’s still a good idea to always close the data 
stream yourself: 

fclose(in_file); 
fclose(out_file); 

Let’s try this out now. 
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rpen your pencil 


This is the code for a program to read all of the data from a GPS 
file and then write the data into one of three other files. See if 
you can fill in the blanks. 

#include <stdio.h> 

#include <stdlib.h> 

#include <string.h> 

int main() 

{ 

char line [80]; 

FILE *in = fopen("spooky.csv" A ); 

FILE *filel = fopen( n ufos.csv", ); 

FILE *file2 = fopen("disappearances.csv ", ); 

FILE *file3 = fopen("others.csv ", ); 

while ( (in, n %7 9[ A \n]\n n , line) == 1) { 

if (strstr (line, "UFO")) 

(filel, n %s\n n , line); 
else if (strstr (line, "Disappearance")) 

(file2, f, %s\n f, , line); 


else 


(file3, n %s\n n , line); 


return 0; 


(filel); 
(file2); 
(file3); 



Dumb Quest? 


9ns 


How many data streams can I have? 


It depends on the operating system, but usually a process 
can have up to 256. The key thing is there's a limited number of 
them, so make sure you close them when you’re done using them. 


Why is FILE in uppercase? 


It's historic. FILE used to be defined using a macro. 
Macros are usually given uppercase names. You’ll hear about 
macros later on. 
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read and write 


parpen your pencil 

Solution 


This is the code for a program to read all of the data from a GPS 
file and then write the data into one of three other files. You were 
to fill in the blanks. 


#include <stdio.h> 

^include <stdlib.h> 

^include <string.h> 

int main () 

{ 

char line [80]; 

FILE *in = fopen("spooky.csv" A 
FILE *filel = fopen ( "ufos.csv" f . 

FILE *file2 = fopen (’ ’disappearances•csv", 

FILE *file3 = f open ( "others . csv f, , . ^ .); 

while ( (in, "%79 [An] \n", line) == 1) 

if (strstr(line, "UFO")) 

.… 办勹 ” 说 (filel , n %s\n n , line); 

else if (strstr(line, "Disappearance")) 


w 

V 

w 

y/ 


,).； 


V 


%s\n", line); 


else 


(file2 


(file3, n %s\n n , line); 




(filel); 
osc .. (file2); 
啤 … (file3); 
return 0; 


The program rims, but... 

If you compile and run the program with: 


ufos.csv 


gcc categorize.c -o categorize && ./categorize 


the program will read the spooky.csv file and split up the data, line by line, into 
three other files — ufos.csv, disappearances.csv, and other.csv. 

That’s great, but what if a user wanted to split up the data differently? What if 
he wanted to search for different words or write to different files? Gould he do 
that without needing to recompile the program each time? 



disappearances.csv 


other.csv 
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There's more to mam() 


The thing is, any program you write will need to give the user the ability to 
change the way it works. If it’s a GUI program, you will probably need to give 
it preferences. And if it’s a command-line program, like our categorize tool, 
it will need to give the user the ability to pass it command-line arguments: 

This is the -pi\rs-t wovd "to -filtcv* -Pov. AH mCV-maid This you y/aht "to cMctV. (or Elvis. 

y/ill be s*tovcd m *t^is 


. 乏二 - Evcv*V*t^nr\<X 

. / categorize mermaid mermaid.csv Elvis elvises.csv the rest.csv , 1 .丄 

— else joes mto 

■tiiis Vile- 

But how do you read command-line arguments from within the 
program? So far, every time you’ve created a main () function, you’ve 
written it without any arguments. But the truth is, there are actually two 
forms of the main () function we can use. This is the second version: 

int main(int arge, char *argv[]) 


/\|| Elvis Sl^vtl 呼 
will be s*to\rcd hcv*c- 


....Do stuff.... 


The main () function can read the command-line arguments as 
an array of strings. Actually, of course, because G doesn’t really 
have strings built-in, it reads them as an array of character pointers to 
strings. Like this: 


./categorize" "mermaid" "mermaid.csv" "Elvis" "elvises.csv" "the rest.csv' 


This is a\rgv[03. 


This ’is av-^vCI3. 


This is av-jvCZJ. 


This 


is av^vR3. 


This is [ 午 ] . 


This is 


TV>c av^umcr>*t »s actually 七 ^ 

of fvoyam vuw 

Like any array in G, you need some way of knowing how long the 
array is. That’s why the main () function has two parameters. 

The arge value is a count of the number of elements in the array. 

Command-line arguments really give your program a lot more 
flexibility, and it’s worth thinking about which things you want 
your users to tweak at runtime. It will make your program a lot 
more valuable to them. 


OK, let’s see how you can add a little flexibility 
to the categorize program. 



Watch it! 


The first argument 
contains the name 
of the program as 
it was run by the 
user. 


That means that the first proper 
command-line argument is 

argv[1]. 
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code magnets 


Code Magnets 


This is a modified version of the categorize program that can read the keywords 
to search for and the files to use from the command line. See if you can fit the correct 
magnets into the correct slots. 

The program runs using: 


./categorize mermaid mermaid.csv Elvis elvises.csv the rest.csv 


#include 

#include 

#include 


<stdio.h> 
<stdlib.h> 
<string.h> 


int main(int argc, char ^argv[]) 


char line[80]; 


f 



fprintf (stderr, "You need to 
return 1; 


★in = 

fopen("spooky.csv", 

"r"); 

^filel 

— fopen ( 

, n w"); 

*file2 

——fopen( 

,"w"); 

*file3 

— fopen ( 

,"w"); 
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while (fscanf (in, "%79 [ A \n]\n n , line) == 1) { 


if (strstr(line. 


)) 

fprintf(filel. 

n %s\n n . 

line); 

else if (strstr(line. 


fprintf(file2. 

n %s\n n . 

line); 

else 

fprintf(file3. 

"%s\n n . 

line); 


fclose (filel); 
fclose (file2); 
fclose (file3); 
return 0; 
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code magnets solution 


Code Magnets Solution 


This is a modified version of the categorize program that can read the keywords 
to search for and the files to use from the command line. You were to fit the correct 
magnets into the correct slots. 

The program runs using: 



./categorize mermaid mermaid.csv Elvis elvises.csv the_rest.csv 

#include <stdio.h> 

#include <stdlib.h> 

#include <string.h> 

int main(int argc, char ^argv[] 

{ 

char line [80]; 

if ( 

fprintf(stderr, "You need to give 5 arguments\n n ); 
return 

FILE *in 

FILE ^filel 

FILE *file2 

FILE *file3 
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creating small tools 


while (fscanf (in, "%79 [ A \n]\n n , line) == 1) { 


I ar gy[i] ] )) 


if (strstr(line 


fprintf(filel, n %s\n n , line); 

else if (strstr (line A 1 ^^ 口 ]」 )) 
fprintf (file2, n %s\n n , line); 
else 

fprintf (file3, n %s\n n , line); 

} 

fclose (filel); 
fclose (file2); 
fclose (file3); 
return 0; 
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test drive 



Tesr DriVq 


OK, let’s try out the new version of the code. You’ll need a test data file 
called spooky, csv. 


30.685163, 
28.304380, 
29.132971, 
28.343065, 
27.868217, 
30.496017, 
26.224447, 
29.401320, 
37.879536, 
22.705256, 
27.166695, 


-68.137207,Type=Yeti 

-74.575195,Type=UFO 

-71.136475,Type=Ship 

-62.753906,Type=Elvis 

-68.005371,Type=Goatsucker 

-73.3337 40 , Type=Disappearance 

-71.477051,Type=UFO 

-66.027832,Type=Ship 

-69.477539,Type=Elvis 

-68.192139,Type=Elvis 

-87.484131,Type=Elvis 


spooky.csv 


Now you’ll need to run the categorize program with a few command¬ 
line arguments saying what text to look for and what filenames to use: 


File Edit Window Help ThankYouVeryMuch 


> categorize UFO aliens.csv Elvis elvises.csv the rest.csv 


When the program runs, the following files are produced: 
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28.304380,-74.575195,Type=UFO 
26.224447,-71.477051,Type=UFO 


A 



aliens.csv 


l-P you y\AV\ clviscs.-t^i ihvough 
yoZjsoh you display i-t ov\ a map. 



WOO Cco-locater 



INEGI. 


MapUnK. Tete AStas 


30.496017,-73.333740,Type=Disappearance 
2 9.401320,-66.027832,Type=Ship 


28.343065,-62.753906,Type=Elvis 
37.87 953 6,-69.4 7753 9,Type=Elvis 
22.705256,-68.192139,Type=Elvis 
27.166695,-87.484131,Type=Elvis 


ww Jersey 

and 


Google 


search the 


the rest.csv 


tlv»s Kas *tV>c Wild ，， 


30.685163,-68.137207,Type=Yeti 


29.132971,-71.136475,Type=Ship 


27.868217,-68.005371,Type=Goatsucker 


Vermont 

Hampshire 

0»d« IsUind 


[27.166695, -87.484131] 

lypc=Hlvis 


elvises.csv 



攻 ifety Cll 6 C^ - 

Although at Head First Labs we never make mistakes (cough), it’s important in real-world 
programs to check for problems when you open a file for reading or writing. Fortunately, 
if there’s a problem opening a data stream, the f open () function will return the value 0. 
That means if you want to check for errors, you should change code like: 


FILE *in = fopen("i_dont_exist.txt ", "r"); 

to this: 


FILE *in; 

if (! (in = fopen( M dont_exist.txt M , M r M ) ) ) { 

fprintf(stderr, "Can't open the file.\n"); 
return 1; 
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command-line options 


Overheard at the Head First Pizzeria 



Chances are, any program you write is going to need 
options. If you create a chat program, it’s going to 
need preferences. If you write a game, the user will 
want to change the shape of the blood spots. And if 
you’re writing a command-line tool, you are probably 
going to need to add command-line options. 


Command-line options are the little switches you often 
see with command-line tools: 


pis^lay all f\rotcsscs, 
ps -ae l 払 w 


tail -f logf ile. out—Display tk ⑶ dJtk Ale, butwi 七 “ 

data -to be added -to the c^d o-f the -file. 


hCW 
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Let the library do the work for you 


Many programs use command-line options, so there’s a special 
library function you can use to make dealing with them a 
little easier. It’s called getopt (), and each time you call it, it 
returns the next option it finds on the command line. 


Let’s see how it works. Imagine you have a program that can 
take a set of different options: 

Use -Pouv- crimes. 
rocket to -e 4 -a Brasilia Tokyo London 


mode enabled- 


This program needs one option that will take a value (-e = engines) 
and another that is simply on or off{ -a 二 awesomeness). You can 
handle these options by calling getopt () in a loop like this: 



The Polite Gul^e - 

The unistd.h header is 
not actually part of the 
standard C library. Instead, 
it gives your programs 
access to some of the 
POSIX libraries. POSIX 
was an attempt to create 
a common set of functions 
for use across all popular 
operating systems. 


Y°^ will heed -to 一 

mdludc this header. 


The Code *to handle 
eadh option ^ocs hcvc- 

Y<>uVc \rcadmg the 

av-gurwCht -Pov- the 
t option hcvc. 


TVsc -f'mal *Uo Imcs 
wake suv-c pas 七 

七 he options y/c vead. 


#include <unistd.h> 

This w Thc a oftio^ is 

•… valid; so is t option, 

while ((ch = getopt(arge, argv, "ae:")) != EOF) 


switch(ch) { 

參參參 

case 'e': 

engine count = optarg; 


The w：w -tha-t 七 he e 
op 七 ion r>ccds av\ 



arge -= optind; 
argv += optind; 


。㈣ ，二 t 上 


Inside the loop, you have a switch statement to handle each of 
the valid options. The string ae : tells the getopt () function 
that a and e are valid options. The e is followed by a colon to tell 
getopt () that the -e needs to be followed by an extra argument, 
getopt () will point to that argument with the optarg variable. 

When the loop finishes, you tweak the argv and arge variables 
to skip past all of the options and get to the main command-line 
arguments. That will make your argv array look like this: 


Brasilia Tokyo London 

This is av-^vCOJ. This is avgvf/J. This is av-^vCZ] 



After processing 
the arguments, 
the Oth argument 
will no longer be 
the program name. 


argv [0] will instead point to the 
first command-line argument that 
follows the options. 
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pizza puzzle 



V»zza VtdcdS 

Looks like someone’s been taking a bite out of the pizza code. See if you can replace 
the pizza slices and rebuild the order pizza program. 


#include <stdio.h> 
#include <unistd.h> 


int main(int argc, char *argv[]) 

{ 

char ^delivery = nn ; 
int thick = 0; 
int count = 0; 
char ch; 


while ( (ch = getopt (argc, argv, "d . ’▼)) ! = EOF) 

switch (ch) { 
case 'd': 


break; 
case 't': 


break; 
default : 


fprintf(stderr, "Unknown option : '%s'\n n , optarg); 


return 
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argc -= optind; 
argv += optind; 


if (thick) 

puts("Thick crust."); 
if (delivery[0]) 

printf ("To be delivered %s.\n n , delivery); 
puts( n Ingredients:"); 


for (count =.; count < .; count++) 

puts(argv[count]); 
return 0; 
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pizza unpuzzled 



?»zza &>L3MtlpH 


Looks like someone’s been taking a bite out of the pizza code. You were to replace 
the pizza slices and rebuild the order pizza program. 


#include <stdio.h> 
#include <unistd.h> 


int main(int argc, char *argv[]) 


char ^delivery 
int thick = 0; 
int count = 0; 
char ch; 


d is -followed by a 乙 oloh 
b 似 use it iakes 


while ((ch = ge 
switch (ch) { 
case 'd': 






)) 



II variable 払 c 

.aqumc^b sullied i\>t d 。?乇广 


OY\- 



㈣ 二仏 


fprintf(stderr, "Unknown option : 



’ ％ s▼\n n , optarg); 


EOF) 
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argc -= optind; 
argv += optind; 

if (thick) 

puts("Thick crust."); 
if (delivery[0]) 

printf("To be delivered %s.\n n , delivery); 
puts ( n Ingredients : ; 


count++) 




puts(argv[count]); 
return 0; 
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test drive 




Tesr DriVq 


Now you can try out the pizza-order program: 


Compile "tKc I File Edit Window Help Anchovies? 



YouVc y>o*t us*m 
av>y options 七 he 
-fivst douflc o( 
times you dal I it 

Then i\ry out the. 
d op"tioh dhd ^ivc 

it avgumcht o-f 


how. 


*bV)C *t 

option docsy> *b 
Sv\y av-^uwcy\*bs- 

Finally, i\ry skiPpi^ 
"the avgumch-t -rov- 
d • it dv-catcs dh 


> gee order_j>izza. c -o order_j>izza 

> ./order_j>izza Anchovies 
Ingredients : 

Anchovies 

> ./order_j>izza Anchovies Pineapple 
Ingredients : 

Anchovies 

Pineapple 

> ./order_j>izza -d now Anchovies Pineapple 
To be delivered now. 

Ingredients : 

Anchovies 

Pineapple 

> ./order_j>izza -d now -t Anchovies Pineapple 
Thick crust. 

To be delivered now. 

Ingredients : 

Anchovies 

Pineapple 

> ./order_j>izza -d 

order_j>izza : option requires an argument ——d 
Unknown option : ▼(null)' 

> 


cv-vov. 


It works! 

Well, you’ve learned a lot in this chapter. You got deep into 
the Standard Input, Standard Output, and Standard Error. 
You learned how to talk to files using redirection and your 
own custom data streams. Finally, you learned how to deal 
with command-line arguments and options. 

A lot of G programmers spend their time creating small tools, 
and most of the small tools you see in operating systems like 
Linux are written in G. If you’re careful in how you design 
them, and if you make sure that you design tools that do one 
thing and do that one thing well, you’re well on course to 
becoming a kick-ass G coder. 
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tJiereiare no ^ 

Dumb Questi9ns 


Can I combine options like -td 
now instead of -d now -t? 

Yes, you can. The getopt () 
function will handle all of that for you. 

What about changing the order of 
the options? 

Because of the way we read the 
options, it won’t matter if you type in -d 

now -t or -t -d now or -td 
now. 


So if the program sees a value on 
the command line beginning with it 
will treat it as an option? 

If it reads it before it gets to the main 
command-line arguments, it will, yes. 


But what if I want to pass negative 
numbers as command-line arguments 
like set_temperature -c -4? 
Won’t it think that the 4 is an option, not 
an argument? 

In order to avoid ambiguity, you 
can split your main arguments from the 
options using So you would write 
set—temperature -c — — -4. 
getopt () will stop reading options 
when it sees the —, so the rest of the line 
will be read as simple arguments. 


BULLET POINTS —— 

■ There are two versions of the 
main () function—one with 
command-line arguments, and one 
without. 

■ Command-line arguments are 
passed to main () as an argument 
count and an array of pointers to the 
argument strings. 

■ Command-line options are 
command-line arguments prefixed 
with 

■ The getopt () function helps you 
deal with command-line options. 


■ You define valid options by passing a 
string to getopt () like ae : . 

■ A “：” (colon) following an option 
in the string means that the option 
takes an additional argument. 

■ getopt () will record the options 
argument using the optarg 
variable. 

■ After you have read all of the options, 
you should skip past them using the 
optind variable. 
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c toolbox 


Your C Toolbox 

You’ve got Chapter 3 under 
your belt，and now you’ve 
added small tools to your 
toolbox. For a complete list of 
tooltips in the book, see Appendix ii. 



The jc*fcop*tO 
-Puhd*tioh makes 
i 七 easier *to 
V"C3cl donr\nr«3hci- 
lihC op 七 iohS. 







Oh 
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4 using multiple source files 

參 Break it down ， 禾 

命 build it up , 



If you create a big program, you don’t want a big source file. 

Can you imagine how difficult and time-consuming a single source file for an enterprise- 
level program would be to maintain? In this chapter, you’ll learn how C allows you to break 
your source code into small, manageable chunks and then rebuild them into one huge 
program. Along the way, you’ll learn a bit more about data type subtleties and get to 
meet your new best friend: make. 


this is a new chapter 
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guess the data type 



Quess tue Data TsPe 

C can handle quite a few different types of data: characters and whole numbers, floating-point 
values for everyday values, and floating-point numbers for really precise scientific calculations. You 
can see a few of these data types listed on the opposite page. See if you can figure out which data 
type was used in each example. 


Remember: each example uses a different data type. 
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Each letter on the 
countdown display 


90：00 

wwrtrQs 


"These a\rc hurrtbev-s 
^Oh-ta'mmg de^ir^al 
points- 


fLoatin^ Points 





naVs r\o^i\ U C, 

t)iav-s av-c ad-tually 

S*boV*cdi \aS,\y\ 0 ^ 

Codes. 

TKat w»ca^s -t^eyVe 
just \r\umbcvs *too( 
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guess the data type solution 





和 eSS twe Data TsPe 8<>LutioH 

C can handle quite a few different types of data: characters and whole numbers, floating-point 
values for everyday values, and floating-point numbers for really precise scientific calculations. You 
can see a few of these data types listed on the opposite page. You were to figure out which data 
type was used in each example. 


Remember: each example uses a different data type. 
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oubl 


long ] 



Each letter on the 
countdown display 



90：00 

wwrtrQs 


Lef s see why 
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data types 


Your quick guide to data types 


char 


的 is the ASCII 

^odc -fov- 


iwt 

If you need to store a whole number, you can generally just use an in t. The exact maximum size of 
an int can vary, but if s guaranteed to be at least 16 bits. In general, an mt can store numbers up 

to a few million. 

short 

But sometimes you want to save a little memory. Why use an int if you just want to store numbers 
up to few hundreds or thousands? That 5 s what a short is for. A short number usually ta es up 

about half the space of an int. 

long 

Yes but what if you want to store a really large count? That^ what the long data type was 
invented for. On some machines, the long data type takes up the 

can hold numbers up in the billions. But because most computers can deal with really large i , 
on a lot of machines, the long data type is exactly the same size as an mt. The maximum size o 

long is guaranteed to be at least 32 bits. 

float 

float is the basic data type for storing floating-point numbers. For most everyday floating-point 
numbers—like the amount of fluid in your orange mocha frappuccmo—you can use a f 1 o . 


double 

Yes, but what if you want to get really precise? If you want to perform calculat 】 on ^= 
accurate to a lar^e number of decimal places, then you might want to use a double. A doub 
takes up twice the memory of a float, and it uses that extra space to store numbers that are larger 

and more precise. 
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using multiple source files 


Pow't put something big into something small 

When you’re passing around values, you need to be careful 
that the type of the value matches the type of the variable 
you are going to store it in. 


Different data types use different amounts of memory. So 
you need to be careful that you don’t try to store a value 
that’s too large for the amount of space allocated to a 
variable, short variables take up less memory than ints, 
and ints take up less memory than longs. 

Now there’s no problem storing a short value inside 
an int or a long variable. There is plenty of spa 
memory, and your code will work correctly: 


short x = 15; 
int y = x; ^ 

printf ("The value of y 


TWis Will say 7 


’m 七 


slioirt 



%i\n 


:m 



The ^oh-tch-ts 


a shov-t will 


always -Pi-t j h 

y )； 

oy a loh^. 



TV)C 

w>ay be *too lav-y *to 
•m a s)io\rt or Sv\ ’mt 


The problems start to happen if you go the other way 
around — if, say, you try to store an int value into a short. 

int x = 100000; is 卞 匕 ode & 

TO\rrw3"t 3 sho\rt v^lue. 

short y = x; ^ 

print("The value of y = %hi\n", y); 


Sometimes, the compiler will be able to spot that 
you’re trying to store a really big value into a small 
variable, and then give you a warning. But a lot 
of the time the compiler won’t be smart enough 
for that, and it will compile the code without 
complaining. In that case, when you try to run the 
code, the computer won’t be able to store a number 
100,000 into a short variable. The computer will 
fit in as many Is and 0s as it can, but the number 
that ends up stored inside the y variable will be very 
different from the one you sent it: 

The value of y = -31072 



Gee| B 形 


So why did putting a large number into a short 
go negative? Numbers are stored in binary. This is 
what 100,000 looks like in binary: 

X <- 0001 1000 0110 1010 0000 

But when the computer tried to store that value 
into a short, it only allowed the value a couple 
of bytes of storage. The program stored just the 
righthand side of the number: 

y <- 1000 0110 1010 0000 

Signed values in binary beginning with a 1 in 
highest bit are treated as negative numbers. And 
this shortened value is equal to this in decimal: 

-31072 
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casta float 


Use casting to put floats into whole numbers 


What do you think this piece of code will display? 

int x = 7; 
int y = 2; 
float z = x / y; 
printf ( "z = %f\n", z); 

The answer? 3.0000. Why is that? Well, x and y are both integers, and if you 
divide integers you always get a rounded-off whole number — in this case, 3. 

What do you do if you want to perform calculations on whole numbers and 
you want to get floating-point results? You could store the whole numbers into 
float variables first, but that’s a little wordy. Instead, you can use a cast to 
convert the numbers on the fly: 

int x = 7; 
int y = 2; 

float z = (float) x / (float) y; 

printf ("z = %f\n", z); 



The (float) will cast an integer value into a float value. The calculation 
will then work just as if you were using floating-point values the entire time. In 
fact, if the compiler sees you are adding, subtracting, multiplying, or dividing 
a floating-point value with a whole number, it will automatically cast the 
numbers for you. That means you can cut down the number of explicit casts 

in your code: . .. 

The Will auxo^at^aiiY 

tas*t y a 仏 3 七， 


float z = (float)x / y; 


^IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIHIIMIIII^ 


You can put some other keywords before data types to change the way that the numbers are interpreted: 


unsigned 

The number will always be positive. Because it doesn’t 
need to worry about recording negative numbers, 
unsigned numbers can store larger numbers 
since there’s now one more bit to work with. So an 
unsigned int stores numbers from 0 to a maximum 
value that is about twice as large as the maximum 
number that can be stored inside an int. There’s also 
a signed keyword, but you almost never see it, because 
all data types are signed by default. 

unsigned char c; 


long 

That’s right, you can prefix a data type with the word 
long and make it longer. So a long int is a longer 
version of an int, which means it can store a larger 
range of numbers. And a long long is longer than 
a long. You can also use long with floating-point 
numbers. 

IS 

ay\d CM oir^ly. 

h really RBfyLU/ 

predisc hur^bev*. 


long double d; 
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TW»s W.II sW 




jrvow 0 


■bo 2-^- 
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using multiple source files 



There’s a new program helping the waiters bus tables at the Head First Diner. The code 
automatically totals a bill and adds sales tax to each item. See if you can figure out what needs 
to go in each of the blanks. 

Note: there are several data types that could be used for this program, but which would you use 
for the kind of figures you’d expect? 


#include <stdio.h> 


.total = 0.0; 

.count = 0; 

.tax_percent = 6; 

.add_with_tax(float f); 

{ 

.tax_rate = 1 + tax—percent / 100 .; 

total = total + (f * tax_rate); 
count = count + 1 ； 
return total; 

} 

int main() 

{ 

# val ; 

printf ("Price of item : ’▼); 
while (scanf("%f ", &val) == 1) { 

printf ( "Total so far : % .2f\n n , add_with_tax(val)); 

printf ("Price of item: ")； a 卞 m 七 

} -fco iwo decimal places. 

printf (’ ▼ \nFinal total : %.2f\n", total); 
printf("Number of items : %hi\n n , count); 
return 0; 

} 7oV>*i is used *to -fo\rrwa*t sho\rU- 
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split the check 


There’s a new program helping the waiters bus tables at the Head First Diner. The code 
firL automatically totals a bill and adds sales tax to each item. You were to figure out what needs to 

go in each of the blanks. 

W Note: there are several data types that could be used for this program, but which would you use 
for the kind of figures you’d expect? 

You heed 

3 small #include <stdio . h> 

-floatihg-poiht 

u •… 和冰 …… total = °* 0; 丁一 職，七 k ? a 朽 

S . sho\r*t . count = 0; ov-dcv-, so ^itW cMoost a short. 

sho\rt tax_percent = 6; 

•.… ^\oai …… add_with_tax (float f) a s-all dash value, so ^11 be a ^loat 

A -float will { 

be 0^ (or - - ^ -floai _tax_rate = 1 + tax—percent / 100 ：0 .; 

*tK*is -fvadtio^. ~ ~ 

total = total + (f * tax rate) ; ^ ,.. 六 " 

- By addm^ 0, you the 

count = count + 1; taltula*t'ioy\ v/o\rk as d -rloat K 

return total; ^ 七’七 as I。。’ 十 

} V^avc a ^olc 

I + / 100; 

int main () M , r. + . ,ri oa + 聽 1 d ^ the value / 

{ casilyU ma 七 lo 此 bemuse W\QQ ^ Q ih 

•.… ^\oai …… val; •• 士，…七一 eU 

printf ("Price of item : ’▼); 
while (scanf( n %f n , &val) == 1) { 

printf ("Total so far : % .2f\n n , add_with_tax(val)); 
printf ("Price of item : ’▼); 

} 

printf (’ ▼ \nFinal total : %.2f\n", total); 
printf("Number of items : %hi\n n , count); 
return 0; 

} 
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using multiple source files 


- Dafa Type Up Cl^se 

Data types are different sizes on different platforms. But how do you 
find out how big an int is, or how many bytes a double takes up? 

Fortunately, the G Standard Library has a couple of headers with the 
details. This program will tell you about the sizes of ints and floats: 

#include <stdio.h> , , » 

#include〈limits .h> i\\t values ^ 丨 e m a 

#±nClude <float.h>^ This , 0htaihS va | ucs 4, 4^ ahd 



TV>'is is 

W 咖 s 七 value 



int main() 

{ 

printf ("The value of INT—MAX is %i\n’ 
printf ("The value of INT MIN is %i\n' 


INT MAX) 


INT MIN) 


printf("An int takes %z bytes\n n , sizeof(int)) 


A 


This is -the 
lowest value. 


printf ("The value of FLT—MAX is %f\n n , FLT—MAX); 
printf ( "The value of FLT—MIN is % .50f\n ", FLT_MIN) 
printf( n A float takes %z bytes\n n , sizeof (float)); 


return 0; 


,L 


: y\uwbcv- 

fey-bes a data 


When you compile and run this code, you will see something like this: 


File Edit Window Help HowBiglsBig 


The value of INT 一 MAX is 2147483647 
The value of INT=MIN is -2147483648 
An int takes 4 bytes 

The value of FLT_MAX is 340282346638528859811704183484516925440.000000 
The value of FLT=MIN is 0.00000000000000000000000000000000000001175494350822 
A float takes 4 bytes 


The values you see on your particular machine will probably be different. 

What if you want to know the details for chars or doubles? Or 
longs? No problem. Just replace INT and FLT with CHAR (chars), DBL 
(doubles), SHRT (shorts), or LNG (longs). 
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no dumb questions 


Why are data types different on 
different operating systems? Wouldn’t it 
be less confusing to make them all the 
same? 

C uses different data types on 
different operating systems and processors 
because that allows it to make the most out 
of the hardware. 

In what way? 

When C was first created, most 
machines were 8-bit. Now, most machines 
are 32 - or 64 -bit. Because C doesn’t specify 
the exact size of its data types, it’s been 
able to adapt over time. And as newer 
machines are created, C will be able to 
make the most of them as well. 



What do 8-bit and 64-bit actually 
mean? 

Technically, the bit size of a computer 
can refer to several things, such as the size 
of its CPU instructions or the amount of 
data the CPU can read from memory. The 
bit size is really the favored size of numbers 
that the computer can deal with. 

So what does that have to do with 
the size of ints and doubles? 

If a computer is optimized best to 
work with 32 -bit numbers, it makes sense 
if the basic data type—the int—is set at 
32 bits. 


I understand how whole numbers 
like ints work, but how are floats 
and doubles stored? How does the 
computer represent a number with a 
decimal point? 

It’s complicated. Most computers 
used a standard published by the IEEE 
(http://tinyurl. com/ 6 defkv 6 ). 

Do I really need to understand 
how floating-point numbers work? 

No. The vast majority of developers 
use floats and doubles without 
worrying about the details. 


Oh wo...ifs the out-of-work actors... 



Some people were never really cut out to be 
programmers. It seems that some aspiring actors are 
filling in their time between roles and making a little 
extra cash by cutting code, and they’ve decided to 
spend some time freshening up the code in the bill- 
totalling program. 

By the time they rejiggered the code, the actors were 
much happier about the way everything looked.. .but 
there’s just a tiny problem. 

The code doesn’t compile anymore. 
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using multiple source files 


Lcf s see whafs happened to the code 

This is what the actors did to the code. You can see they really just 
did a couple of things. 



The code has had some comments added, and they also changed 
the order of the functions. They made no other changes. 

So there really shouldn’t be a problem. The code should be good to 
go, right? Well, everything was great, right up until the point that 
they compiled the code... 
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test drive 



Tqst DriVq 


If you open up the console and try to compile the program, this happens: 


> gcc totaller.c -o totaller && ./totaller 
totaller.c : In function "main" : 

totaller.c:14: warning : format "%.2f" expects type 
"double", but argument 2 has type "int" 
totaller.c : At top level : 

totaller. c: 23 : error : conflicting types for n add—with—tax' 1 
totaller.c:14: error : previous implicit declaration of 
"add with tax" was here 


Bummer. 


That’s not good. What does error : conflicting types for 
’ add_with_tax ' mean? What is a previous implicit declaration? And why 
does it think the line that prints out the current total is now an int? Didn’t 
we design that to be floating point? 

The compiler will ignore the changes made to the comments, so that 
shouldn’t make any difference. That means the problem must be caused by 

changing the order of the functions. But if the order is the problem, 
why doesn’t the compiler just return a message saying something like: 

O 0 


Seriously, why doesn’t the compiler give us a little help here? 

To understand exactly what’s happening here, you need to get inside the 
head of the compiler for a while and look at things from its point of view. 
You’ll see that what’s happening is that the compiler is actually trying to be 
a little too helpful. 
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using multiple source files 


Compilers don’t like surprises 


So what happens when the compiler sees this line of code? 


o 


❺ 


o 


printf("Total so far : % .2f\n ”， add— with—tax(val)); 

The compiler sees a call to a function it doesn’t recognize. 

Rather than complain about it, the compiler figures that it will find out more about the 
function later in the source file. The compiler simply remembers to look out for the function 
later on in the file. Unfortunately, this is where the problem lies... 



Hey, here's a call to a function Ive 
never heard of. But ril keep a note of it 
for now and find out more later. 


o 


1 






The compiler needs to know what data type the function will return. 

Of course, the compiler can’t know what the function will return just yet, so it makes an 
assumption. The compiler assumes it will return an int. 


0 


Meh. I bet the function 
returns an int. Most do. 


— 0 jy 


When it reaches the code for the actual function, it returns a 'conflicting 
types for *add—with—tax … error. 

This is because the compiler thinks it has two functions with the same name. One function is 
the real one in the file. The other is the one that the compiler assumed would return an int. 


A function called add—with—tax() that 
returns a float??? But in my notes it says we’ve 
already got one of these returning an int... 


0 


o 







_ 

The computer makes an assumption that the function returns an int, when in reality it 
returns a float. If you were designing the C language, how would you fix the problem? 
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correct order 


( Hello? I really don’t care 
how the C language solves the 
problem. Just put the functions in 

the correct freaking order! 


You could just put the functions back in the correct 
order and define the function before you call it in main(). 

Changing the order of the functions means that you can avoid the 
compiler ever making any dangerous assumptions about the return types 
of unknown functions. But if you force yourself to always define functions 
in a specific order, there are a couple of consequences. 


Fixing function order is a paiw 

Say you’ve added a cool new function to your code that everyone 
thinks is fantastic: 

int do—whatever(){...} 

float do_something—fantastic(int awesome 一 level) {...} 
int do_stuff() { 

do_something—fantastic(11); 



What happens if you then decide your program will be even better if you add 
a call to the do_something fantastic () function in the existing 
do whatever () code? You will have to move the function earlier in 


the file. Most coders want to spend their time improving what their code 
can do. It would be better if you didn’t have to shuffle the order of the 
code just to keep the compiler happy. 


Iw some situations, there is wo correct order 


OK, so this situation is kind of rare, but occasionally you might write some 
code that is mutually recursive: 


float ping() 


TV^CV-C *»S Y\0 
{jo vcovdcv' 
七 扒 s . 




o 



If you have two functions that call each other, then one of them will 
always be called in the file before it’s defined. 

For both of those reasons, it’s really useful to be able to define functions in 
whatever order is easiest at the time. But how? 
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using multiple source files 


Split the declaration from the definition 


Remember how the compiler made a note to itself about the function 
it was expecting to find later in the file? You can avoid the compiler 
making assumptions by explicitly telling it what functions it 
should expect. When you tell the compiler about a function, it’s 
called a function declaration: 


W 7 


t _V>as 1 


The declaration is just a function signature: a record of what the 
function will be called, what kind of parameters it will accept, and 

what type of data it will return. 


Once you’ve declared a function, the compiler won’t need to make any 
assumptions, so it won’t matter if you define the function after you call it. 

So if you have a whole bunch of functions in your code and you 
don’t want to worry about their order in the file, you can put a list of 
function declarations at the start of your G program code: 


float do—something—fantastic(); 
double awesomeness_2_dot_0(); 
int stinky—pete(); 
char make maguerita(int count); 


But even better than that, G allows you to take that whole set of 
declarations out of your code and put them in a header file. You’ve 
already used header files to include code from the G Standard Library: 


#include 


<stdio.h> 




TWis Imc will \uWdt 
toy\*tcir\*b o-f iicadcv- 
-filc tailed stdio.Vv 


Let’s go see how you can create your own header files. 
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add a header 


Crcatmg your first header file 

To create a header, you just need to do two things: 



Create a new file with a .h extension. 

If you are writing a program called totaller, then create a file called 
totaller.h and write your declarations inside it: 



You won’t need to include the main () function in the header file, 
because nothing else will need to call it. 


totaller.h 



Include your header file in your main program. 

At the top of your program, you should add an extra include line: 


#include <stdio.h> 


y °"^^ #±nClUde，，t0taller * h， 




When you write the name of the header file, make sure you 


totaller.c 


surround it with double quotes rather than angle brackets. Why 
the difference? When the compiler sees an include line with 
angle brackets, it assumes it will find the header file somewhere 
off in the directories where the library code lives. But your 
header file is in the same directory as your .c file. By wrapping 
the header filename in quotes, you are telling the compiler to 
look for a local file. 


i _. Lotal iicadcv- -f iles also "mdude 
div-ct-tov-y but you will K\ov-mall' 

丄 u 认本 AWtcbors as C 


When the compiler reads the #include in the code, it will read 
the contents of the header file, just as if it had been typed into 
the code. 

Separating the declarations into a separate header file keeps 
your main code a little shorter, and it has another big advantage 
that you’ll find out about in a few pages. 


^inducte is a 


preprocessor 


For now, let’s see if the header file fixed the mess. 


instruction. 
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using multiple source files 



Tqst DriVQ 


Now when you compile the code, this happens: 



Uo CV"V"OV" 


The compiler reads the function declarations from the 
header file, which means it doesn’t have to make any guesses 
about the return type of the function. The order of the 
functions doesn’t matter. 

Just to check that everything is OK, you can run the 
generated program to see if it works the same as before. 


I File Edit Window Help UseHeaders | 


> ./totaller 
Price of item: 1.23 
Total so far : 1.30 
Price of item: 4.57 
Total so far : 6.15 
Price of item: 11.92 
Total so far : 18.78 
Price of item: A D 
Final total : 18.78 
Number of items : 3 



py»CSS CW - P "to s*tof 

pvoyam -from ask'mj -fo\r more 卜以 s. 
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be the compiler 



BE . C 辦 ll 改 


Look at the programfielow, 


• Part of tire 


program is missing. Your job is to play 
like you’re tire compiler and say A^iat 


you would do if each of tire 
candidate code fragments 
on tire ri^lit were slotted 
intone missing space. 


Candidate codt ^ocs Wc. 



#include <stdio.h> 


printf("A day on Mercury is %f hours\n n , day); 
return 0; 

} 

float mercury—day—in—earth days() 

{ 

return 58.65; 

} 

int hours_in_an_earth_day() 

{ 

return 24; 
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ttc\rc 


3\re 


todt -Pv-agr^Ch-ts. 


float mercury_day_in_earth days(); 
int hours_in_an_earth day(); 

int main() 

{ 

float length—of day = mercury_day_in_earth days() 
int hours = hours_in—an—earth day(); 
float day = length of day * hours; 


Mav-k i\\t feo^cs 
j you 七 Wk a 代 

You can compile the code. 


You should display a warning. 
The program will work. 


float mercury_day_in_earth days(); 

int main() 

{ 

float length_of_day = mercury_day_in_earth days() 
int hours = hours_in_an—earth day(); 
float day = length of day * hours; 


You can compile the code. 
You should display a warning. 
The program will work. 


int main() 

{ 

float length_of day = mercury_day_in_earth days(); 
int hours = hours—in_an—earth day(); 
float day = length of day * hours; 


You can compile the code. 
You should display a warning. 
The program will work. 


float mercury—day_in—earth days(); 
int hours_in_an—earth day(); 

int main() 

{ 

int length—of day = mercury_day_in—earth days() 
int hours = hours—in_an—earth day(); 
float day = length of day * hours; 


You can compile the code. 
You should display a warning. 
The program will work. 
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be the compiler solution 



BE . C 辦 ll 改 §©ki 


©n 


Look at tire pro^ramljelow. Part of the 


program is missing. Your job was to play 
like you’re tiie compiler and say wiM 


you would do if each of the 
candidate code fragments 
ontiie ri^lit were slotted 
into the missing space. 


#include <stdio.h> 


printf ("A day on Mercury is %f hours\n f, , day); 
return 0; 

} 

float mercury—day—in—earth days() 

{ 

return 58.65; 

} 

int hours_in_an—earth day() 

{ 

return 24; 
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float mercury_day_in—earth days(); 
int hours_in_an—earth day(); 

int main() 

{ 

float length_of day = mercury_day_in—earth days(); 
int hours = hours—in_an—earth day(); 
float day = length of day * hours; 


float mercury_day_in—earth days(); 

int main() 

{ 

float length_of day = mercury_day—in—earth days() 
int hours = hours_in_an—earth day(); 
float day = length of day * hours; 


Ef 



You can compile the code. 


You should display a warning. 


The program will work. 


V,ll fee a kausc you/ay 七 

， / bcW TV>c 

fectausc -,*t W.ll ^css 七咖 





You can compile the code. 


You should display a warning. 


The program will work. 


int main() 

{ 

The pv-oajrar, bc^usc youVc dalliha 

a 士 1 。 3 七 -ruhdtioh Without de^laH^a i£ -pivst 



float length 

of day = mercury day in earth days(); 

int hours = 

hours in an earth day(); 

float day = 

length of day * hours; 


float mercury_day_in—earth days(); 
int hours in an earth day(); 


TV>c vaviablc should be a -floai- 


int main() 

{ 

int length—of day = mercury_day—in—earth days() 
int hours = hours_in_an—earth day(); 
float day = length of day * hours; 



You can compile the code. 


You should display a warning. 


The program will work. 


Vill 七 

〆 bu*t »*t ^ioy\{, work 
be^duse Will be 3 
f\roblcm. 

d 


You can compile the code. 


You should display a warning. 


The program will work. 
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no dumb questions 


So I don’t need to have 
declarations for int functions? 

Not necessarily, unless you are 
sharing code. You’ll see more about this 
soon. 

I’m confused. You talk about the 
compiler preprocessing? Why does the 
compiler do that? 

j\l Strictly speaking, the compiler just 
does the compilation step: it converts the C 
source code into assembly code. But in a 
looser sense, all of the stages that convert 
the C source code into the final executable 
are normally called compilation, and the 
gcc tool allows you to control those 
stages. The gcc tool does preprocessing 
and compilation. 



What is the preprocessor? 

Preprocessing is the first stage in 
converting the raw C source code into a 
working executable. Preprocessing creates 
a modified version of the source just before 
the proper compilation begins. In your code, 
the preprocessing step read the contents of 
the header file into the main file. 

Does the preprocessor create an 
actual file? 

No, compilers normally just use pipes 
for sending the stuff through the phases of 
the compiler to make things more efficient. 

Why do some headers have 
quotes and others have angle brackets? 

Strictly speaking, it depends on the 
way your compiler works. Usually quotes 
mean to simply look for a file using a 
relative path. So if you just include the 
name of a file, without including a directory 
name, the compiler will look in the current 
directory. If angle brackets are used, it 
will search for the file along a path of 
directories. 


What directories will the compiler 
search when it is looking for header 
files? 

The gcc compiler knows where the 
standard headers are stored. On a Unix- 
style operating system, the header files are 
normally in places like /usr/local/include, 
lusr/include, and a few others. 

So that’s how it works for 
standard headers like stdio.h? 

Yes. You can read through the 
stdio.h file on a Unix-style machine in 
/usr/include/stdio.h. If you have the MinGW 
compiler on Windows, it will probably be in 
C:\MinG W\include\stdio.h. 

Can I create my own libraries? 

Yes; you’ll learn how to do that later 
in the book. 
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^^BUUET POINTS - 

■ Function declarations are often put 
into header files. 

■ You can tell the compiler to read 
the contents of a header file using 

^include. 


■ If the compiler finds a call to a 
function it hasn’t heard of, it will 
assume the function returns an int. 

■ So if you try to call a function before 
you define it, there can be problems. 


■ Function declarations tell the 

compiler what your functions will look 
like before you define them. 


■ The compiler will treat included 
code the same as code that is typed 
into the source file. 


■ If function declarations appear at the 
top of your source code, the compiler 
won’t get confused about return 
types. 



TMs Table's ^eservei 


C is a very small language. Here is the entire set 
of reserved words (in no useful order). 

Every C program you ever see will break into just 
these words and a few symbols. If you use these 
for names, the compiler will be very, very upset. 


auto 

if 

break 

int 

case 

long 

char 

register 

continue 

return 

default 

short 

do 

sizeof 

double 

static 

else 

struct 

entry 

switch 

extern 

typedef 

float 

union 

for 

unsigned 

goto 

while 

enum 

void 

const 

signed 

volatile 
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code sharing 


If you have common features 

Chances are, when you begin to write several programs in G, you will 
find that there are some functions and features that you will want to 
reuse from other programs. For example, look at the specs of the two 
programs on the right. 

XOR encryption is a very simple way of disguising a piece of text by 
XOR-ing each character with some value. It’s not very secure, but it ? " 
very easy to do. And the same code that can encrypt text can also be 
used to decrypt it. Here’s the code to encrypt some text: 


■^ile__hider 

Read -the con-ten-ts 
0乓 a Ale and crea-te 

an en( ^ r ypted version 
using yoQ encryp-tion. 


I 

s 


void medhs doh >- t 
vrtuirh ahythihg. 


Loof 七 Wr。— 七 ^ 
away update 

C^tv-Y^cd vc\rs\oy\. 


~3void encrypt (char *message) 

{ ^Pass 3 po'm*bcv- *to 3ir\ 

char c ； away Wt«ov> 

while (*message) { 

*message = *message A 
message++; 

} 



This 

you II XOR 

with 

the hunrtbev* 1>\. 


^essa^-> v( ^ er 

eead a ser ves 


po'm^ a 

^av-at*bcv-? You because 
is a y\uwcv-\t da*t3 七 


,.ifs good to share code 


Clearly, both of those programs are going to need to use 
the same encrypt () function. So you could just copy 
the code from one program to the other, right? That’s not 
so bad if there’s just a small amount of code to copy, but 
what if there’s a really large amount of code? Or what if 
the way the encrypt () function works needs to change 
in the future? If there are two copies of the encrypt () 
function, you will have to change it in more than one 
place. 

For your code to scale properly, you really need to find 
some way to reuse common pieces of code — some way 
of taking a set of functions and making them available in 
a bunch of different programs. 


How would you do that? 



Imagine you have a set of 
functions that you want to 
share between programs. 

If you had created the C 
programming language, how 
would you allow code to be 
shared? 
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You can split the code into separate files 

If you have a set of code that you want to share among several files, it 
makes a lot of sense to put that shared code into a separate .c file. If the 
compiler can somehow include the shared code when it’s compiling the 
program, you can use the same code in multiple applications at once. So 
if you ever need to change the shared code, you only have to do it in one 
place. 


TWis "is 
sV)av-cd fi-odc- 


Read a file, 
rewrite a file. 


Encrypt ) Read Standard 
text J Input, display text. 


0 


O 


o 


o 


IIOOI 

lliioiool 

OOIOIOI 

voiouj 

file hider 


The ^pi|c\r will dor^pile 

todc ih-to eadk pvoyam. 


TooTbi 

moiool 

OOI0101 

You *to 3 way lolollj^ 

o( -tcllmj domfilev- *to message_hider 
tv-ca*tc *tV)C -fv-om 

multiple SOUV-dC -files. 


If you want to use a separate .c file for the shared code, that gives 
us a problem. So far, you have only created programs from single .c 
source files. So if you had a G program called blitz_hack, you 
would have created it from a single source code file called blitz—hack.c. 


But now you want some way to give the compiler a set of source 
code files and say, “Go make a program from those.” How do 
you do that? What syntax do you use with the gcc compiler? And 
more importantly, what does it mean for a compiler to create a single 
executable program from several files? How would it work? How 
would it stitch them together? 


To understand how the C compiler can create a 
single program from multiple files, let’s take a 
look at how compilation works... 
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how compilation works 


Compilation behind the scenes 

To understand how a compiler can compile several source files 
into a single program, you’ll need to pull back the curtain and 
see how compilation really works. 

o 


Hmmmm...so I need to 
compile the source files 
into a program? Lefs see 
what I can cook up... 


O 


o 


Preprocessing ： fix the source. 

The first thing the compiler needs to do is fix the source. It needs to add in 

any extra header files it’s been told about using the #include directive.^ ,, 

r lt might also need to expand or skip over some sections of the program. 、 ’s 
Once it’s done, the source code will be ready for the actual compilation. 

/"t W do "this 

广 d f Youll scc 

^ "to use the. 

"the book. 




❺ 


just a 

y/o\rd -fov- 


Compilation ： translate into assembly. 

The G programming language probably seems pretty low level, but 
the truth is it’s not low level enough for the computer to understand. The 
computer only really understands very low-level machine code 
instructions, and the first step to generate machine code is to convert 
the G source code into assembly language symbols like this: 

movq -24 (%rbp ), %rax 
movzbl(%rax ), %eax 
movl %eax A %edx 

Looks pretty obscure? Assembly language describes the individual 
instructions the central processor will have to follow when running the 
program. The G compiler has a whole set of recipes for each of the 
different parts of the G language. These recipes will tell the compiler how 
to convert an if statement or a function call into a sequence of assembly 
language instructions. But even assembly isn’t low level enough for the 
computer. That’s why it needs". 
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Assembly ： generate the object code. 

The compiler will need to assemble the symbol codes into machine or 
object code. This is the actual binary code that will be executed by 
the circuits inside the GPU. 


This is a ^ally 

diirty joke ih ^^ 10010101 00100101 11010101 01011100 
Code 


So are you all done? After all, you’ve taken the original G source code 
and converted it into the Is and 0s that the computer’s circuits need. 
But no, there’s still one more step. If you give the computer several files 
to compile for a program, the compiler will generate a piece of object 
code for each source file. But in order for these separate object files to 
form a single executable program, one more thing has to occur … 




Unking ： put it all together. 

Once you have all of the separate pieces of object code, you need to 
fit them together like jigsaw pieces to form the executable program. 
The compiler will connect the code in one piece of object code that 
calls a function in another piece of object code. Linking will also make 
sure that the program is able to call library code properly. Finally, the 
program will be written out into the executable program file using 
a format that is supported by the operating system. The file format 
is important, because it will allow the operating system to load the 
program into memory and make it run. 



So how do you actually tell gcc that we want to make 
one executable program from several separate source 
files? 
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sharing variables 


The shared code needs its own header file 


If you are going to share the encrypt.c code between 
programs, you need some way to tell those programs 
about the encrypt code. You do that with a header file. 


V^>u II ihdludc the licddcv" 
inside Chd\rypt.d. 



void encrypt(char ^message); 



encrypt.h 


Include encrypt.h iw your program 

You’re not using a header file here to be able to reorder the 
functions. You’re using it to tell other programs about 
the encrypt () function: 


#include "encrypt.h" 

void encrypt(char ^message) 

{ 

char c; 

while (^message) { 


★ 


message 


★message A 31 


message++; 



encryptc 


^include <stdio.h> 

#include "encrypt.h' 


int main() 

{ 

char msg[80]; 
while (fgets(msg, 80, 
encrypt(msg); 
printf ( n %s n , msg); 

} 

} 





stdin)) { 



message—hider.c 

Having encrypt.h inside the main program will mean the compiler 
will know enough about the encrypt () function to compile the 
code. At the linking stage, the compiler will be able to connect 
the call to encrypt (msg) in message_hider.c to the actual 
encrypt () function in encrypt.h. 

Finally, to compile everything together you just need to pass the 
source files to gcc: 

gcc message_hider.c encrypt.c -o message_hider 


^i>iiiiiiiiii[iiiiniiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiiMMiiiiiiiiiiimiiiimm:iiiu. 

圍 § 

圍 I 

1 § 

Sharing variables 

I I 

I I 

圍 I 

I I 

圍 I 

i I 

You’ve seen how to share functions 

I I 

between different files. But what if 

I I 

you want to share variables? Source 
code files normally contain their 

I 画 

own separate variables to prevent a 
variable in one file affecting a variable 
in another file with the same name. 

圍 圍 

But if you genuinely want to share 
variables, you should declare them in 
your header file and prefix them with 

圍 圍 

the keyword extern: 

I I 

I I 

I I 

I I 

I I 

extern int passcode; 

I 圍 

I 画 

I I 

I I 

I I 

I i 
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Tqst DriVq 


Let’s see what happens when you compile the message—hider 
program: 


毗 ⑶ you ihe 1 File Edit Window Help Shhh - 

you Uh Chicv- "text ahd 
sec ihc Ch^iryptcd vc^-sioh. 



You Y\ttd bo tomfilc todt 

y/rbV^ both source -files. 


y^>U £>dh CVCK\ ^p3SS l"t 
tcmtwb o*f ihe C\r\d\ryp*t ^ 

flic bo 



> gcc message 一 hider•c encrypt.c -o message—hider 

> ./message_hTder 

I am a secret message 
V? 〜 r? 〜？ lz|mzk?rzll~xz 

> •/message 一 hider < encrypt.h 
ipv{?zq|mfok 7 |w 〜 m 5 ?rzll 〜 xz 6 $ 


TV message hideir pvogiram is usmg the 
Chd\ryp -(：0 -ruh^tioh -fvorw Chdvyp 七 . 乙 . 


The program works. Now that you have the encrypt () 
function in a separate file, you can use it in any program 
you like. If you ever change the encrypt () function to be 
something a little more secure, you will need to amend only 
the encrypt, c file. 


BULLET POINTS —— 

■ You can share code by putting it into 
a separate C file. 

■ You need to put the function 
declarations in a separate .h header 
file. 

■ Include the header file in every C file 
that needs to use the shared code. 

■ List all of the C files needed in the 
compiler command. 



off piste — 

Write your own program 
using the encrypt () 

function. Remember, 
you can call the same 
function to decrypt text. 
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recompiling files 



Man! Every time I make a 
simple change in one file, it 
takes an age to recompile! And 
rm working on a schedule... 





using multiple source files 


Ifs wot rocket sciewce...or is it? 


Breaking your program out into separate source files not only means 
that you can share code between different programs, but it also means you 
can start to create really large programs. Why? Well, because you can start 
to break your program down into smaller self-contained pieces of 
code. Rather than being forced to have one huge source file, you can have 
lots of simpler files that are easier to understand, maintain, and test. 

So on the plus side, you can start to create really large programs. The 
downside? The downside is.. .you can start to create really large 
programs. G compilers are really efficient pieces of software. They take 
your software through some very complex transformations. They can 
modify your source, link hundreds of files together without blowing 
your memory, and even optimize the code you wrote, along the way. 
And even though they do all that, they still manage to run quickly. 

But if you create programs that use more than a few files, the time it 
takes to compile the code starts to become important. Let’s say it takes 
a minute to compile a large project. That might not sound like a lot of 
time, but it’s more than long enough to break your train of thought. If 
you try out a change in a single line of code, you want to see the result 
of that change as quickly as possible. If you have to wait a full minute 
to see the result of every change, that will really start to slow you down. 



f you dhahgc cvch ohc lihc ih or>c -file, 
it -take the ^ompi| C ir a lo^g -time 
to Compile all -the souv-^c -files 

V 


un*'t. c 




olo rC 



r etro. 


c 






Compiler 





nooifci 

\moiool 

looioiol 

lioiomjl 

launch 




Think carefully. Even a simple change might mean running a large, slow compile to 
see the result. Given what you know about the compilation process, how could you 
speed up the time to recompile the program? 


e.c 
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save copies 


Pow't recompile every file 


If you’ve just made a change to one or two of your source code files, it’s 
a waste to recompile every source file for your program. Think what 
happens when you issue a command like this: 广 

V 

gcc reaction control.c pitch motor.c ... 


Skipp •… 3 a -few V^CV"C- 

engine.c -o launch 


What will the compiler do? It will run the preprocessor, compiler, and 
assembler for each source code file. Even the ones that haven’t changed. And 
if the source code hasn’t changed, the object code that’s generated for 
that file won’t change either. So if the compiler is generating the object 
code for every file, every time, what do you need to do? 

Save copies of the compiled code 

If you tell the compiler to save the object code it generates into a file, it 
shouldn’t need to recreate it unless the source code changes. If a file does 
change, you can recreate the object code for that one file and then pass 
the whole set of object files to the compiler so they can be linked. 


(-P this souvtc 

•Pile 

it s the ohly 
ohc you heed 
"to \rcdonf»pilc ， 




file 



C source 
file 



IOOI 

ooioiot 
101011 ij 


Object 
code file 


A\ Executable 

/ou will st，|| ^cd io vuh the lihkcv, but 

㈣七 <dil« will still be "tk same. 

^ jooiotj ^ — 丁 C-OW'PlIcV* Will U^d3*tc 

objcd*t Code tWs 
s*tov*cd m 3 


Object 
code file 


If you change a single file, you will have to recreate the object code file 
from it, but you won’t need to create the object code for any other file. 
Then you can pass all the object code files to the linker and create a new 
version of the program. 


So how do you tell gcc to save the object code in a 
file? And how do you then get the compiler to link the 
object files together? 
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using multiple source files 


First compile the source iwto object files 

You want object code for each of the source files, and you can 
do that by typing this command: 

The * • c will match every G file in the current directory, 
and the -c will tell the compiler that you want to create an 
object file for each source file, but you don’t want to link them 
together into a full executable program. 

then, link them together 


g[cc -c will compile tke 
code tut won’t link it. 


藝 


膽 


1 



Now that you have a set of object files, you can link them 
together with a simple compile command. But instead of 
giving the compiler the names of the G source files, you tell it 
the names of the object files: 

C sou\r^C -files, lis*t 

TVis is sWilav *to *tV^c gec * . o _o launch 七 he object -f iles. 

Compile dommar\ds ^ 

you vc used bc-fo\rc- This v/ill nf»a*t£.h dll "the object -files'm "the div*e^tovy. 


1 


Souv-tc -f ile 


s 


^cc -c 


t locTtik 
nioiod 

s 


The compiler is smart enough to recognize the files as 
object files, rather than source files, so it will skip most of 
the compilation steps and just link them together into an 
executable program called launch. 

OK, so now you have a compiled program, just like before. 

But you also have a set of object files that are ready to be 
linked together if you need them again. So if you change just 
one of the files, you’ll only need to recompile that single file 
and then relink the program: 

This is -the ohly gCC _C thruster * c <~* TW，S 

■flat’s Chafed. gec *.0-0 launch This will l.mk cvcvyihmg 

Even though you have to type two commands, you’re saving a 
lot of time: 



Object -Pi I 

\L 


cs 


nooTti 

liiioiod 
loot 01 cl 
llQlQljJ 


iocTC^ 

llloiod 

ooiofdl 

fotouij 



gee - 0 


Compile 七 ime: 
LinK -tione ： 



6 e^ore 

- - - 

a mins 30 secs 
(o secs 




BcW, you wc\rc 匕 ompi|i h3 cvc^ry (\\^ bui,d is -fasten. 


Koy/> youVc 
domfilmj only *bv^c 

The Imk is 
still scdor\ds. 



七 able 
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file update 



ExeRciSe 


Here is some of the code that’s used to control the engine management system on the craft. 
There’s a timestamp on each file. Which files do you think need to be recreated to make the 
ems executable up to date? Circle the files you think need to be updated. 



thruster.c 

11:43 



turbo.c 

12:15 



graticule.c 

14:52 



servo.c 

13:47 



thruster.o 

11:48 



turbo.o 

12:22 



graticule.o 

14:25 



servo.o 

13:46 



1001 
111010 ( 
OOIOI 
IOIOII 


ems 

14:26 
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And in the galley, they need to check that their code’s up to date as well. Look at the times against the files. Which of 
these files need to be updated? 



microwave.c 

15:42 



popcorn.c 

17:05 



juicer.c 

16:41 



microwave .。 

18:02 



popcorn.o 
17:07 



juicer.o 

16:43 


1001 

liioiool 

0010101 

iplOlJJJ 

galley 

17:09 
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files updated 



t°^S ExeRclSe 
^SotutvOH 


Here is some of the code that’s used to control the engine management system on the craft. 
There’s a timestamp on each file. You were to circle the files you think need to be recreated to 
make the ems executable up to date. 



thruster.c 

11:43 



turbo.c 

12:15 



graticule.c 

14:52 



servo.c 

13:47 


o y\ccds *to be 
y-ctompilcdi) i*ts 

oldicv* *tV\c l3*tcs*t 


vcv"Sior\ 




IOOI 
111010 ( 
OOIOI 

IOIOII 

• 一 

thruster.o 

11:48 


IOOI D| 
llioiool 
ooioiot 

ipioinj 

turbo.o 

12:22 



sc\rvo-o heeds -fco be 
\TC^owr»pilcd, because it s 
o\AtY thah its Souv-^c. 




cws as N^cii- 


o 
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And in the galley, they need to check that their code’s up to date as well. Look at the times against the files. Which of 
these files need to be updated? 



microwave.c 

15:42 



popcorn.c 

17:05 



juicer.c 

16:41 






|v(oy\C *bV^c ^ o -f iles 
-bo fee 代 toweled. 
T\\^ avc all 於瞻 

七 so^rtt -f iles. 


microwave.o 
18:02 


popcorn.o 
17:07 


juicer.o 

16:43 
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need automation 


Ifs hard to keep track of the files 



I thought the whole point of saving time 
was so I didiVt have to get distracted. 
Now the compile is faster, but I have to 
think a lot harder about how to compile 
my code. Where's the sense in that? 


It’s true: partial compiles are faster, but you 
have to think more carefully to make sure 
you recompile everything you need. 

If you are working on just one source file, things will be 
pretty simple. But if you’ve changed a few files, it’s pretty 
easy to forget to recompile some of them. That means the 
newly compiled program won’t pick up all the changes 
you made. Now, of course, when you come to ship the 
final program, you can always make sure you can do a full 
recompile of every file, but you don’t want to do that while 
you’re still developing the code. 

Even though it’s a fairly mechanical process to look for 
files that need to be compiled, if you do it manually, it will 
be pretty easy to miss some changes. 

Is there something we can use to automate the process? 
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using multiple source files 



. 


Wouldn’t it be dreamy if there were 
a tool that could automatically recompile 
just the source thafs changed? But I 
know ifs just a fantasy... 
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make it automatic 


Automate your builds with the make tool 


You can compile your applications really quickly in gcc, as long as 
you keep track of which files have changed. That’s a tricky thing to 
do, but it’s also pretty straightforward to automate. Imagine you have 
a file that is generated from some other file. Let’s say it’s an object 
file that is compiled from a source file: 


(-P the thv-us-tev-.d 

-Pile is hcwcv, you ^ thruster, c 
{jo V-c^orwpilc. 


> thruster.o 




How do you tell if the thruster, o file needs to be recompiled? You just 
look at the timestamps of the two files. If the thruster.o file is older 
than the thruster, c file, then the thruster, o file needs to be recreated. 
Otherwise, it’s up to date. 


|-f *t)i\nAS*tc\r o 
-f ile is you 

do〆 七 v\Ctd *to 

\rcdow>pilc. 



y \ c^i bcs*t 


That’s a pretty simple rule. And if you have a simple rule for 
something, then don’t think about it — automate it... 

make is a tool that can run the compile command for you. The 
make tool will check the timestamps of the source files and the 
generated files, and then it will only recompile the files if things have 
gotten out of date. 


But before you can do all these things, you need to tell make about 
your source code. It needs to know the details of which files depend 
on which files. And it also needs to be told exactly how you want to 
build the code. 


What does make need to know? 

Every file that make compiles is called a target. Strictly speaking, 
make isn’t limited to compiling files. A target is any file that is 
generated from some other files. So a target might be a zip archive 
that is generated from the set of files that need to be compressed. 


For every target, make needs to be told two things.. 


o 

o 


The dependencies. 

Which files the target is going to be generated from. 

The recipe. 

The set of instructions it needs to run to generate the file. 


Together, the dependencies and the recipe form a rule. A rule tells 
make all it needs to know to create the target file. 


Hmm...this files OK. 

And this one. And this one. 
AncL.ah, this ones out of 
date, rd better send that 
to the compiler. 


O 

o 
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using multiple source files 


How make works 

Let’s say you want to compile thruster.c into some object code in 
thruster.o. What are the dependencies and what’s the recipe? 

thruster. c - ^ thruster. o 


The thruster.o file is called the target, because it’s the file you 
want to generate, thruster.c is a dependency, because it’s a file the 
compiler will need in order to create thruster.o. And what will the 
recipe be? That’s the compile command to convert thruster.c into 
thruster.o. 


gcc -c 


.Tiiis is rule -fo\r 
thruster.c ⑽ 


Make sense? If you tell the make tool about the dependencies 
and the recipe, you can leave it to make to decide when it needs 
to recompile thruster.o. 

But you can go further than that. Once you build the thruster.o 
file, you’re going to use it to create the launch program. That 
means the launch file can also be set up as a target, because it’s 
a file you want to generate. The dependency files for launch are 
all of the .0 object files. The recipe is this command: 



The make tool 
may have a 
different name 
on Windows. 


Because make 
came from the Unix world, 
there are different flavors of it 
available in Windows. MinGW 
includes a version of make 
called mingw32-make and 
Microsoft produce their own 
version called nmake. 


gcc *.o -o launch 

Once make has been given the details of all of the dependencies 
and rules, all you have to do is tell it to create the launch file, 
make will work out the details. 


議 

launch.c 



launch.o 

1 

launch.h 



launch 



thruster.o 



thruster.h 



thruster.c 


But how do you tell make about the 
dependencies and recipes? Let’s find out. 


So Ive got to compile the 
launch program? Hmm... 
First ril need to recompile 
thruster.o, because \fs out 
of date; then I just need 
to relink launch. 


O 
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make a makefile 


Tell make about your code with a makefile 

All of the details about the targets, dependencies, and 
recipes need to be stored in a file called either makefile or 
Makefile. To see how it works, imagine you have a pair of 
source files that together create the launch program: 


lotoiijj 


launch 


lau^.o is t。—led 分。 … av>d ^ 

lOiOUll 





»*tKv-us*tcv-o is domfilcd *fv-om 
*tV>vus*tcv.V> *thv-us*tcv- d. 


launch.o 


thruster.o 


ir 





launch.c 


launch.h 


thruster.h 



thruster.c 


The launch program is made by linking the launch.o and 
thruster.o files. Those files are compiled from their matching 
G and header files, but the launch.o file also depends on the 
thruster.h file because it contains code that will need to call a 
function in the thruster code. 


This is how you’d describe that build in a makefile: 

A *tav-yt is a 七 ^ 七 1 s 

This is a iar^ci. ^o'm^ *to fee y 敵 a 七 cd. 



gcc -c launc 



launch.o : launch.c launch.h thruster.h 

丁 , , lauMh.o depends oh these 

^ / W Ucs. 

^WLES. ^thruster. o : thruster.h thruster. c 

-^TWis is d *fov 

crea 七七 Wus*bcv.o. 



gcc -c thruster.c 今 


launch : launch.o thruster.o 
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gcc launch.o thruster.o -o launch 

v-cdipcs MUST bejm v/i-th a tab dhavad-tev. 


WatcK it! 


All of the 
recipe lines 
MUST begin 
with a tab 
character. 


If you just try to indent the 
recipe lines with spaces, the 
build won’t work. 
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Tesr DriVq 


Save your make rules into a text file called Makefile in the same 
directory; then, open up a console and type the following: 

^ ou ^ tellihg io, 

-the lauhdh -file. 

make r\ccds *to / 

a Idu^.o W\i\\ *tWis Imc. 


I File Edit Window Help MakeltSo 



> make launch 
gcc -c launch.c 
gcc -c thruster.c 

gcc launch.o thruster.o -o launch 


七 hen needs "to dvcaic 
"thv-us-tev- o v/i-th this I’me. 

pmally) make I'mks object 
-to dveate laur\tii pvoyam. 


You can see that make was able to work out the sequence of 
commands required to create the launch program. But what 
happens if you make a change to the thruster, c file and then run 
make again? 


wke "o lohgev heeds ^ 

"to Compile buh 匕 h. 匕. 


la^.o is already uf -to date 


File Edit Window Help MakeltSo 


> make launch 
gcc -c thruster.c 

gcc launch.o thruster.o -o launch 


make is able to skip creating a new version of launch.。. Instead, it 
just compiles thruster.o and then relinks the program. 
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no dumb questions 


th&rejcir 

Dumb 


e no o 

Questi9ns 


Is 


make just like ant? 


Ifs probably better to say that build tools like ant and 
rake are like make, make was one of the earliest tools used to 
automatically build programs from source code. 


This seems like a lot of work just to compile source 
code. Is it really that useful? 

Yes, make is amazingly useful. For small projects, make 
might not appear to save you that much time, but once you have 
more than a handful of files, compiling and linking code together 
can become very painful. 


If I write a makefile for a Windows machine, will it work 
on a Mac? Ora Linux machine? 

Because makefiles calls commands in the underlying 
operating system, sometimes makefiles don’t work on different 
operating systems. 

Can I use make for things other than compiling code? 

Yes. make is most commonly used to compile code. But it 
can also be used as a command-line installer, or a source control 
tool. In fact, you can use make for almost any task that you can 
perform on the command line. 


IIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIIMIIIMIIIIMJ- 



Why indent with tabs? 

It’s easy to indent recipes with 
spaces instead of tabs. So why 
does make insist on using tabs? 
This is a quote from make's 
creator, Stuart Feldman: 


Why the tab in column 1? ... It 
worked, it stayed. And then a 
few weeks later I had a user 
population of about a dozen, 
most of them friends, and I 
didn’t want to screw up my 
embedded base. The rest, sadly, 
is history.” 


6ee} Bits - 

make takes away a lot of the pain of compiling files. 
But if you find that even it is not automatic enough, 
take a look at a tool called autoconf: 


h ttp://www.gnu. org/software/autoconf/ 


autoconf is used to generate makefiles. C 
programmers often create tools to automate the 
creation of software. An increasing number of them 
are available on the GNU website. 
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using multiple source files 


Make Magnets 


Hey, baby, if you don’t groove to the latest tunes, then you’ll love the program the 
guys in the Head First Lounge just wrote! oggswing is a program that reads an Ogg 
Vorbis music file and creates a swing version. Sweet! See if you can complete the 



makefile that compiles oggswing and then uses it to convert a .ogg file: 


This ^ohvcv-ts 
whitchhcv-dyogg 
"fco swihg.ogg. 


oggswing 


swing.ogg: 
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make magnets solution 


Make Magnets Solution 



Hey, baby, if you don’t groove to the latest tunes, then you’ll love the program the 
guys in the Head First Lounge just wrote! oggswing is a program that reads an 
Ogg Vorbis music file and creates a swing version. Sweet! You were to complete the 
makefile that compiles oggswing and then uses it to convert a .ogg file: 


oggswing : 



swing.ogg: 


[TAB] 



.... oggswing 



Gee} Bits 



The make tool can do far, far more than we have space to 
discuss here. To find out more about make and what it can do 
for you, visit the GNU Make Manual at: 


[SPACES] 


h ttp://tinyurl. com/yczmjx 
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BULLET POINTS 


■ It can take a long time to 
compile a large number of 
files. 


■ You can speed up 

compilation time by storing 
object code in *.o files. 


■ make knows about the 
dependencies between files, 
so it can compile just the files 
that change. 

■ make needs to be told about 
your build with a makefile. 


■ The gcc can compile 
programs from object files as 
well as source files. 

■ The make tool can be used 
to automate your builds. 


■ Be careful formatting your 
makefile: don’t forget to 
indent lines with tabs instead 
of spaces. 










c toolbox 



Your C Toolbox 


You’ve got Chapter 4 under 
your belt，and now you’ve 
added data types and header 
files to your toolbox. For a complete 
list of tooltips in the book, see 
Appendix ii. 




slioirts 
^o\r s^H 
whole 
humbc^s. 



Wsc lohas j 

wily big 
whole humbc^*s. I 

Use *m*b -for | 

k 1 


most v/^olc 

y\umbcV"S. 


Use -floats for 

most 


W 七 W 占 0 
A 咖 at— 


doubles 
^ \rcslly 

(1 。也 3 poih^s. 


Pui 

dcdl^\r ol^iohS 
' h ci hccidcv- 

-Pile. 


养 mdude <> 
-for library 
headers. 


^mdludc 
K0> -foV" lo63l 
headers. 




Save objed*t 
^odc ih^o 
"f'lcs {jo speed 
U P y 财 builds. 

Use ^ 

\)\a\\A S * \ 
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CLabl 

Arduino 

This lab gives you a spec that describes a program 
for you to build, using the knowledge you’ve gained 
over the last few chapters. 

This project is bigger than the ones you’ve seen so far. 
So read, the whole thing before you get started, and 
give yourself a little time. And don’t worry if you get 
stuck. There are no new C concepts in here, so you 
can move on in the book and come back to the lab 
later. 

We’ve filled, in a few design details for you, and. we’ve 
made sure you’ve got all the pieces you need to write 
the code. You can even build, the physical device. 

It’s up to you to finish the job, but we won’t give you 
the code for the answer. 





The spec: make your houseplant talk 

Ever wished your plants could tell you when they need watering? 
Well, with an Arduino they can! In this lab, you’ll create an 
Arduino-powered plant monitor, all coded in G. 

Here’s what you’re going to build. 



The physical device 

The plant monitor has a moisture sensor that measures how wet your 
plant’s soil is. If the plant needs watering, an LED lights up until the 
plant’s been watered, and the string “Feed me!” is repeatedly sent to 
your computer. 

When the plant has been watered, the LED switches off and the 
string “Thank you, Seymour!” is sent once to your computer. 



The siai us is 
shoWh oh 幻呷 ‘. 

V 


Feed me 


Feed me! 


Feed me 


tv lW r 吵 W ^ 




TV moisWc sc^sov 
dctctls or y^oi 


个 

Soldc'rlcss 


Iovc3diioo3v"d 















































Av-duiho v 

boa\rd 


The Ardumo 

The brains of the plant monitor is an 
Arduino. An Arduino is a small micro¬ 
controller-based open source platform for 
electronic prototyping. You can connect it 
to sensors that pick up information about 
the world around it, and actuators that 
respond. All of this is controlled by code 
you write in G. 

The Arduino board has 14 digital IO pins, 
which can be inputs or outputs. These 
tend to be used for reading on or off 
values, or switching actuators on or off. 

The board also has six analog input pins, 
which take voltage readings from a sensor. 

The board can take power from your 
computer’s USB port. 


The Arduino IPE 

You write your G code in an Arduino IDE. The IDE allows 
you to verify and compile your code, and then upload it to the 
Arduino itself via your USB port. The IDE also has a built-in 
serial monitor so that you can see what data the Arduino is 
sending back (if any). 

The Arduino IDE is free, and you can get hold of a copy from 
www. arduino. cc/en/Main/ Software. 


USB 



Digital 

pihs O 

■fco 



ARDUINO 



丁 he IDE lets you upload todt 
A'rduiho boavd... 



...ar\d sec s 

ba 匕 k via sevial fov 七 


























Puild the physical device 

You start by building the physical device. While this bit’s 
optional, we really recommend that you give it a go. Your 
plants will thank you for it. 


iVe used Av*du*mo Who. 




Puild the moisture sensor 


Take a long piece of jumper wire and attach it to the head of one 
of the galvanized nails. You can either wrap the wire around the 
nail or solder it in place. 

Once you’ve done that, attach another long piece of jumper wire 
to the second galvanized nail. 

The moisture sensor works by checking the conductivity between 
the two nails. If the conductivity is high, the moisture content must 
be high. If it’s low, the moisture content must be low. 


n/ou W'W 

1 U 印 

1 10•' 





IFin 'tKe end 
v/ivc 七 he V^c3(i 



Connect the UP 


Look at the LED. You will see that it has one 
longer (positive) lead and one shorter (negative) 
lead. 

Now take a close look at the Arduino. You will 
see that along one edge there are slots for 14 
digital pins labeled 0—13, and another one next 
to it labeled GND. Put the long positive lead of 
the LED into the slot labeled 1 3, and the shorter 
negative lead into the slot labeled GND. 

This means that the LED can be controlled 
through digital pin 13. 



ihc sho^ri 

LED lead iirto ihe 

M labeled 狐 



|y\scv-b LtP 

lead m*bo slot 
-fov 





rx%B« ARDUINO 






Connect the moisture sensor 


Connect the moisture sensor as shown below: 


o 

❺ 

❺ 

❹ 

o 

o 


Connect a short jumper wire from the GND pin on the Arduino to slot D15 on the breadboard. 
Connect the 10K Ohm resistor from slot C15 on the breadboard to slot CIO. 

Connect a short jumper wire from the 0 analog input pin to slot DIO on the breadboard. 

Take one of the galvanized nails, and connect the wire attached to it to slot BIO. 

Connect a short jumper wire from the 5V pin on the Arduino to slot G5 on the breadboard. 
Take the other galvanized nail, and connect the wire attached to it to slot B5. 



J hc mois ^ s ChSov is 
to dhalog i h pu-t pm O, whi 虬略吣 

wc \rcad analog daia th 

sehsov via this pi h . 


r A 

Ov\t 

^a'il ^ a-tta^cd 
{p 七 Wis … 


x 个 

•• 七 he 

"ail is atiac,\\cd -to 
"this wive. 


That’s the physical Arduino built. Now for the C code 
















Here's what your code should do 

Your Arduino G code should do the following. 

Read from the moisture sensor 

The moisture sensor is connected to an analog input pin. You 
will need to read analog values from this pin. 

Here at the lab, we’ve found that our plants generally need 
watering when the value goes below 800, but your plant’s 
requirements may be different — say, if it’s a cactus. 




Write to the UP 

The LED is connected to a digital pin. 

When the plant doesn’t need any more water, write to the digital 
pin the LED is connected to, and get it to switch off the LED. 

When the plant needs watering, write to the digital pin and get it 
to switch on the LED. For extra credit, get it to flash. Even better, 
get it to flash when the conditions are borderline. 


Write to the serial port 


( Thank you, 
( Seymour! 


When the plant needs watering, repeatedly write the string 
“Feed me!” to the computer serial port. 

When the plant has enough water, write the string “Thank 
you, Seymour!” to the serial port once. 

Assume that the Arduino is plugged in to the computer USB 
socket. 






















Here's what your C code should look like 

An Arduino G program has a specific structure. Your program 
must implement the following: 



You car\ add 
c%*tv*a -fur\dtioy\s 

ar\A dcdlavatior\s 

i-f you like) bu*t 
*t^csc 
*bwo -fu^d*tior\s 

七 lie Code ^ior\i 

y/ovk- 


The easiest way of writing the Arduino G code is with the 
Arduino IDE. The IDE allows you to verify and compile 
your code, and then upload your completed program to the 
Arduino board, where you’ll be able to see it running. 

The Arduino IDE comes with a library of Arduino functions 
and includes lots of handy code examples. Turn the page to 
see a list of the functions you’ll find most useful when creating 
Arduino. 




Here are some useful Ardumo functions 

You’ll need some of these to write the program. 

void pinMode(int pin, int mode) 

Tells the Arduino whether the digital pin is an input or output, mode can be either 
INPUT or OUTPUT. 


int digitalRead (int pin) 

Reads the value from the digital pin. The return value can be either HIGH or LOW. 

void digitalWrite(int pin, int value) 

Writes a value to a digital pin. value can be either HIGH or LOW. 

int analogRead(int pin) 

Reads the value from an analog pin. The return value is between 0 and 1023. 


void analogWrite(int pin, int value) 

Writes an analog value to a pin. value is between 0 and 255. 

void Serial.begin(long speed) 

Tells the Arduino to start sending and receiving serial data at speed bits per second. 
You usually set speed to 9600. 


void Serial.println( val) 

Prints data to the serial port, val can be any data type. 

void delay(long interval) 

Pauses the program for interval milliseconds. 


The finished product 

You’ll know your Arduino project is complete when you 
put the moisture sensor in your plant’s soil, connect the 
Arduino to your computer, and start getting status updates 
about your plant. 
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5 structs, unions, and bitfields 




參 Roll your own structures 





Most things in life are more complex than a simple number. 

So far, you’ve looked at the basic data types of the C language, but what if you want to 
go beyond numbers and pieces of text, and model things in the real world? structs 
allow you to model real-world complexities by writing your own structures. In this 
chapter, you’ll learn how to combine the basic data types into structs, and even 
handle life’s uncertainties with unions. And if you’re after a simple yes or no, bitfields 
may be just what you need. 


this is a new chapter 





complicated data 


Sometimes you need to hand around 

You’ve seen that G can handle a lot of different types of data: 
small numbers and large numbers, floating-point numbers, 
characters, and text. But quite often, when you are recording 
data about something in the real world, you’ll find that you need 
to use more than one piece of data. Take a look at this example. 
Here you have two functions that both need the same set of data, 
because they are both dealing with the same real-world thing. 

/* Print out the catalog entry */ 


a lot of data 



乩 ar 氺 ” just youVc 
bo pass s-tv-'mj 1’ 心 raU. 





lOhS 


void catalog (const char *name, const char 

{ 

printf ("%s is a %s with %i teeth. He is 
name, species, teeth, age); 


*species, 
%i\n n . 


int teeth, int age) 


tolkc the 
set o-p 
pav-arwetev-s. 


/* Print the label for the tank */ 

S^void label(const char *name, const char ^species , 


int teeth, int age) 


printf("Name : %s\nSpecies :% s\n%i years old, %i teeth\n", 
name, species, teeth, age); 


Now that’s not really so bad, is it? But even though you’re just 
passing four pieces of data, the code’s starting to look a little 
messy: 


You 




int main() 

{ 

passim the ， catalog ("Snappy' 
same W label ( n Snappy n , 

pieces return 0 ; 


"Piranha 
Piranha", 


, 69, 4); 

69, 4); 

or\ly ov\t bu*t you v-c 
f>dss'm^ *fou\r pieces da*ba. 


So how do you get around this problem? What can you do to 
avoid passing around lots and lots of data if you’re really only 
using it to describe a single thing? 
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structs, unions, and bitfields 


Cubicle conversation 



I don’t really see the 
problem. Ifs only four 
pieces of data. 


Joe: Sure, it’s four pieces of data now, but what if we change the 
system to record another piece of data for the fish? 


Frank: That’s only one more parameter. 


Jill: Yes, it’s just one piece of data, but we’ll have to add that to 
every function that needs data about a fish. 


Joe: Yeah, for a big system, that might be hundreds of functions. 
And all because we add one more piece of data. 


Frank: That’s a good point. But how do we get around it? 


Joe: Easy, we just group the data into a single thing. Something 
like an array. 


Jill: I m not sure that would work. Arrays normally store a list of 
data of the same type. 


Joe: Good point. 


Frank: I see. We’re recording strings and ints. Yeah, we can’t 
put those into the same array. 


Jill ： I don’t think we can. 


Joe ： But come on, there must be some way of doing this in G. 
Let’s think about what we need. 




Frank: OK, we want something that lets us refer to a whole set 
of data of different types all at once, as if it were a single piece of 
data. 


Jill ： I don’t think we’ve seen anything like that yet, have we? 


What you need is something that will let you record 
several pieces of data into one large piece of data. 
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structs 


Create your own structured data types with a struct 


If you have a set of data that you need to bundle together into 
a single thing, then you can use a struct. The word struct is 
short for structured data type. A struct will let you take 
all of those different pieces of data into the code and wrap them 
up into one large new data type, like this: 

struct fish { 

const char *name; 
const char *species; 
int teeth; 
int age; 



This will create a new custom data type that is made up of a 
collection of other pieces of data. In fact, it’s a little bit like an 
array, except: 



Name: Snappy 
Species: Piranha 
Teeth: 69 
Age: 4 years 


o 

o 


It’s fixed length. 

The pieces of data inside the struct are given names. 


But once you’ve defined what your new struct looks like, how do you 
create pieces of data that use it? Well, it’s quite similar to creating a new 
array. You just need to make sure the individual pieces of data are in the 
order that they are defined in the struct: 

This is "the species. 

杓此 ” j s 、 

"the da-fca lyp# ) struct fish snappy = { "Snappy" , "Piranha' 

.. 广 

is vaviable "This is the 


This is of 

69, * is 


tJieretcire no o 

Dumb Qliestl9ns 


OK. So does this struct store 
the string? 


But you can store the whole string 
in there if you want? 


Hey, wait a minute. What’s that 
const char thing again? 

const char * is used for strings 
that you don’t want to change. That means 
it’s often used to record string literals. 


In this case, no. The struct here 
just stores a pointer to a string. That means 
it’s just recording an address, and the string 
lives somewhere else in memory. 


Yes, if you define a char array in 
the string, like char name [20];. 
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Just give them the fish 

Now, instead of having to pass around a whole collection of 
individual pieces of data to the functions, you can just pass your 
new custom piece of data: 

/* Print out the catalog entry */ 

void catalog(struct fish f) 


/* Print the label for the tank */ 

void label(struct fish f) 




Vhy 伽 祕赵 
i fer ymi 


One of the great 
things about data 
passing around 


inside structs is 


that you can change the 
contents of your struct 
without having to change 
the functions that use it. For 
example, let’s say you want 
to add an extra field to fish ： 


struct fish { 


Looks a lot simpler, doesn’t it? Not only does it mean the 
functions now only need a single piece of data, but the code that 
calls them is easier to read: 


const char *name; 
const char ^species; 
int teeth; 


struct fish snappy = {"Snappy " r "Piranha ", 69, 4}; 
catalog(snappy); 
label(snappy); 


So that’s how you can define your custom data type, but how 
do you use it? How will our functions be able to read the 
individual pieces of data stored inside the struct? 


Wrapping parameters 
in a struct makes your 
code more stable. 


int age; 

int favorite music; 


All the catalog () and 
label () functions have been 
told is they they’re going to 
be handed a fish. They don’t 
know (and don’t care) that the 
fish now contains more data, 
so long as it has all the fields 
they need. 

That means that structs 
don’t just make your code 
easier to read, they also 
make it better able to cope 
with change. 
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use 

Read a strucfs fields with the operator 

Because a struct’s a little like an array, you might think you 
can read its fields like an array: 


struct fish snappy = 
printf("Name = %s\n n , 


get ah 

>v- i-f yo 


You 

cvvov- i-r you 
■bry *to \read a 
匕 七 -field 
like *rt ； s Sy\ 
av-vay. 


"Snappy", "piranha ", 69, 4}; 

snappy [ 0 ] ) ; s ^dP?V v/ds d fomtev- *to av-v-ay, you 

would adtess -tiic -f ield like 


I File Edit Window Helo Fish 


> gee fish.c -o fish 
fish.c : In function 'main' : 

fish.c : 12 : error : subscripted value is neither array nor pointer 

> 〜 一 


But you can’t. Even though a struct stores fields like an array, 
the only way to access them is by name. You can do this using 
the operator. If you’ve used another language, like JavaScript 
or Ruby, this will look familiar: 


struct fish snappy = 
printf( n Name = %s\n n . 


"Snappy ", "piranha ", 69, 4}; 

snappy 


• is 七 he name atbriburte m 


I File Edit Window Heb Fish 


> gcc fish.c -o fish 

> ./fish 
Name = Snappy 

> —一 


TiVis will ve 七 uv • 灼七 he 
stirmg W 


OK, now that you know a few things about using structs ， 
let’s see if you can go back and update that code... 
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Piranha 

Puzz]e 



Your job is to write a new version of the catalog () 
function using the fish struct. Take fragments 
of code from the pool and place them in the blank 
lines below. You may not use the same fragment 
more than once, and you won’t need to use all 
the fragments. 


void catalog(struct fish f) 

{ 

printf("%s is a %s with %i 

• r r 


int main() 

{ 

struct fish snappy = {"Snappy ", "Piranha", 69, 4}; 
catalog(snappy); 

/* We're skipping calling label for now */ 
return 0; 


teeth. He is %i\n". 



Note: each thing from 
the pool can be used 
only once! 
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piranha unpuzzled 


Piranha 

^s^Puzz]e ^ajutlan 

Your job was to write a new version of the catalog () 
function using the fish struct. You were to 
take fragments of code from the pool and place 
them in the blank lines below. 



void catalog(struct fish f) 

{ 

printf("%s is a %s with %i teeth. He is %i\n n , 

f • .name r f • species r f - .teeth.. r ...f.. * ..39?..... ^ ; 

} 

int main() 

{ 

struct fish snappy = {"Snappy ", "Piranha", 69, 4}; 
catalog(snappy); 

/* We're skipping calling label for now */ 
return 0; 
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Tesr DriVq 


You’ve rewritten the catalog () function, so it’s pretty easy to 
rewrite the label () function as well. Once you’ve done that, 
you can compile the program and check that it still works: 


fiey, look, somcohc ; s 
usihg rwolkc... 7 

TWis Ime is out -〜 ^ 

by i\\t da-talojO < 

These lihCS a\rc fv-ihted 

by the IdbdO -fub^tioh- 


B III U |||1 疆||||| 圓丨 11 圓 II l Mj I Ijllilil I^MI 

> make pool^puzzle && •/pool 一 puzzle 
gcc pool^puzzle.c 一 o pool^puzzle 

Snappy is a Piranha with 69 teeth. He is 4 
Name : Snappy 
Species : Piranha 
4 years old, 69 teeth 

> 


That’s great. The code works the same as it did before, but now 
you have really simple lines of code that call the two functions: 

catalog(snappy); 
label (snappy); 


Not only is the code more readable, but if you ever decide 
to record some extra data in the struct, you won’t have to 
change anything in the functions that use it. 



So is a struct just an array? 

No, but like an array, it groups a number of pieces of data 
together. 

An array variable is just a pointer to the array. Is a 
struct variable a pointer to a struct? 

a struct variable is a name for the struct itself. 


I know I don’t have to, but could I use [0], [1]to 
access the fields of a struct? 


A ： 

A: 


No, you can only access fields by name. 


Are structs like classes in other languages? 


They're similar, but it's not so easy to add methods to 

structs. 
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如^晰 In jy[e_ry Up Ckse —— 

When you define a struct, you’re not telling the computer to 
create anything in memory. You’re just giving it a template for 
how you want a new type of data to look. 



The assignment 
copies the 
pointers to strings ， 
not the strings 
themselves. 


struct fish { 

const char *name; 
const char ^species; 
int teeth; 
int age; 

}； 

But when you define a new variable, the computer will need to 
create some space in memory for an instance of the struct. 
That space in memory will need to be big enough to contain all of 
the fields within the struct: 


When you assign one struct to 
another, the contents of the struct 
will be copied. But if, as here, that 
includes pointers, the assignment 
will just copy the pointer values. 
That mesns the name and species 
fields of gnasher and snappy 
both point to the same strings. 


struct fish snappy = {"Snappy ", "Piranha", 69, 4}; 


TWis is a 
*bo a 




This is also a poihtcir io a stv-'mg. 

A 


*name 

* species 

69 

4 


Snappy” 


‘Piranlia” 



S*tov^c ^ 七 ^ y\uwbcv 

of 七 a 灼 d ay. 


So what do you think happens when you assign a struct to another 
variable? Well, the computer will create a brand-new copy of the 
struct. That means it will need to allocate another piece of memory 
of the same size, and then copy over each of the fields. 


struct fish snappy = {"Snappy ", "Piranha", 69, 4}; 
struct fish gnasher = snappy; 



Remember: when you’re assigning struct variables, 
you are telling the computer to copy data. 
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Caw you put owe struct mside another? 

Remember that when you define a struct, you’re actually 
creating a new data type. G gives us lots of built-in data types 
like ints and shorts, but a struct lets us combine existing 
types together so that you can describe more complex objects to the 
computer. 

But if a struct creates a data type from existing data types, 
that means you can also create structs from other 
structs. To see how this works, let’s look at an example. 

^ TV^CSC a^rc tWmy ow La llkcs . 

struct preferences { tz 

const char *food; 
float exercise hours; 


struct fish { 

const char ^name 


Vis is a s*tvud*t mside 3 s*t\rud*t- 


const char ^species; 
int teeth; 

This is a struct preferences care ; TW»s \s tailed 

个 

} ’ -field is called bui i-t y/ill 

•fields dc-Pmcd by -the stw 七 . 


犧 y nest 



Why would you want 
to do this? So you can 
cope with complexity, 
structs give us bigger 
building blocks of data. 

By combining structs 
together, you can create 
larger and larger data 
structures. You might 
have to begin with just 
ints and shorts, but 
with structs, you can 
describe hugely complex 
things, like network 
streams or video images. 


This code tells the computer one struct will contain another 
struct. You can then create variables using the same array¬ 
like code as before, but now you can include the data for one 
struct inside another. 


struct fish snappy = {"Snappy", "Piranha ", 

Once you’ve combined structs together, you can access the 
fields using a chain of operators: 


This is 七 he s*bru 匕七 da*ta 
-fov {}\t dav-c -f ield- 


69, 4, {"Meat", 7.5}}; 

This is the vitc TW^s vaWc U 

-Po\f da\rc -Pood. taw 从⑷ s O' ou ' rS ’ 


printf("Snappy likes 
printf("Snappy likes 


to eat %s n , snappy.care.food); 

to exercise for %f hours" , snappy.care.exercise hours); 


OK, lefs try out your new struct skillz … 
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ExeRciSe 


The guys at the Head First Aquarium are starting to record lots of data about each of their fish 
guests. Here are their structs: 


struct exercise { 

const char ^description 
float duration; 


struct meal { 

const char ^ingredients; 
float weight; 


struct preferences { 
struct meal food; 
struct exercise exercise; 

In¬ 
struct fish { 

const char *name; 
const char ^species; 
int teeth; 
int age; 

struct preferences care; 
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This is the data that will be recorded for one of the fish: 

Name : Snappy 
Species : Piranha 
Food ingredients : meat 
Food weight : 0.2 lbs 

Exercise description : swim in the jacuzzi 
Exercise duration 7.5 hours 


Question 0: How would you write this data in C? 


struct fish snappy = 


Question 1 : Complete the code of the label () function so it produces output like this: 


Name : Snappy 
Species : Piranha 
4 years old, 69 teeth 

Feed with 0.20 lbs of meat and allow to swim in the jacuzzi for 7.50 hours 

void label (struct fish a) 

{ 

printf("Name : %s\nSpecies :% s\n%i years old, %i teeth\n n , 
a.name, a.species, a.teeth A a.age); 
printf("Feed with %2.2f lbs of %s and allow to %s for %2.2f hours\n n , 
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exercised 



t°^S Exe^dSe 

R.SoLvtvOH 


The guys at the Head First Aquarium are starting to record lots of data about each of their fish 
guests. Here are their structs: 


struct exercise { 

const char ^description 
float duration; 


struct meal { 

const char ^ingredients; 
float weight; 


struct preferences { 
struct meal food; 
struct exercise exercise; 

In¬ 
struct fish { 

const char *name; 
const char ^species; 
int teeth; 
int age; 

struct preferences care; 
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This is the data that will be recorded for one of the fish: 


Name : Snappy 
Species : Piranha 
Food ingredients : meat 
Food weight : 0.2 lbs 

Exercise description : swim in the jacuzzi 
Exercise duration 7.5 hours 


Question 0: How would you write this data in C? 

struct fish snappy = u Piv-ahha w , 0 . 2 ], [Wim m -the ^ c \ xzjzj ), , 7.5}}}; 

Question 1 : Complete the code of the label () function so it produces output like this: 

Name : Snappy 
Species : Piranha 
4 years old, 69 teeth 

Feed with 0.20 lbs of meat and allow to swim in the jacuzzi for 7.50 hours 

void label (struct fish a) 

{ 

printf("Name : %s\nSpecies :% s\n%i years old, %i teeth\n n , 
a.name A a.species, a.teeth, a.age); 
printf("Feed with %2.2f lbs of %s and allow to %s for %2.2f hours\n n , 
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hello typedef 


these struct commands seem kind 
of wordy. I have to use the struct keyword when I define 
a struct, and then I have to use it again when I define a 
variable. I wonder if there's some way of simplifying this. 


O 


You can give your struct a proper name using typedef. 

When you create variables for built-in data types, you can use simple short 
names like int or double, but so far, every time you’ve created a variable 
containing a struct you’ve had to include the struct keyword. 


struct cell_phone { 
int cell_no; 
const char ^wallpaper; 
float minutes of charge; 


struct cell phone p = {5557879, "sinatra.png ", 1.35}; 



But G allows you to create an alias for any struct that 
you create. If you add the word typedef before the struct 
keyword, and a type name after the closing brace, you can call 
the new type whatever you like: 


■typcdc-P 

你 you 
"to give 

the stirud-t 


type 3 hCW 


-^typedef struct cell-phone { 

int cell_no; 

const char ^wallpaper; 

float minutes_of 一 charge; 

} phone; phohe will become dlias (ov' 

Vbrud ： “ll—phohe.” 


phone p = {5557879, "sinatra.png"^ 1.35} 

tJoYi, Yihcv\ ihe domfilcv secs i 七 will 

*tvca*t like w s*tvutt 

typedefs can shorten your code and make it . 

easier to read. Let’s see what your code will look 
like if you start to add typedefs to it... 


^/hat should I call 
my new type? 

If you use typedef to create an alias for a 
struct, you will need to decide what your 
alias will be. The alias is just the name of your 
type. That means there are two names to think 
about: the name of the struct (struct 
cell-phone) and the name of the type 
(phone). Why have two names? You usually 
don’t need both. The compiler is quite happy 
for you to skip the struct name, like this: 

I typedef struct { 

I int cell no; 

I — 

I const char ^wallpaper; 

I float minutes_of_charge; 

} phone; 

phone p = {5557879, "s.png ", 1.35}; 
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A 

ExeRciS^ 

■- *» • 


It’s time for the scuba diver to make his daily round of the tanks, and he needs a new label on 
his suit. Trouble is, it looks like some of the code has gone missing. Can you work out what the 
missing words are? 


#include <stdio.h> 


_struct { 

float tank_capacity; 
int tank_psi; 

const char *suit material; 


.struct scuba { 

const char *name; 
equipment kit; 

} diver; 

void badge (. d) 

{ 

printf ( "Name : %s Tank : %2.2f (%i) Suit : %s\n f, , 

d.name f d.kit.tank_capacity A d.kit.tank_psi A d.kit.suit_material); 

} 

int main() 

{ 

randy = {"Randy ", {5.5, 3500, "Neoprene"}}; 

badge(randy); 
return 0; 
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labeled randy 


A 

ExeRciS^ 

SpLviiPH 


It’s time for the scuba diver to make his daily round of the tanks, and he needs a new label on 
his suit. Trouble is, it looks like some of the code has gone missing. Could you work out what the 
missing words were? 


#include <stdio.h> 


.struct { 

float tank_capacity; 
int tank_psi; 

const char *suit_material; 

. .； 

. struct scuba 

const char *name; 

equipment kit; to&Cr dctidcd bo ^vc 

diver; ^_ 〆- iicv-c- Bu*t you II jus*t use dWcv *tyfc 


void badge ( diver 


d) 


printf("Name : %s Tank : %2.2f(%i) Suit : %s\n n , 

d.name A d.kit.tank capacity, d.kit.tank psi, d.kit.suit material) 


int main() 

{ 

diver . randy = { "Randy ", {5.5, 3500, "Neoprene" } }; 

badge(randy); 
return 0; 
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BULLET POINTS - 

■ A struct is a data type made from a 
sequence of other data types. 

■ structs are fixed length. 

■ struct fields are accessed by name, 
using the <struct>< field name 〉 
syntax (aka dot notation). 


■ struct fields are stored in memory in the 
same order they appear in the code. 

■ You can nest structs. 

■ typedef creates an alias for a data type. 

■ If you use typedef with a struct, then 
you can skip giving the struct a name. 


theretare no ^ 

Dumb Questions 


Do struct fields get placed 
next to each other in memory? 

Sometimes there are small gaps 
between the fields. 

Why’s that? 

The computer likes data to fit inside 
word boundaries. So if a computer uses 
32-bit words, it won’t want a short, say, 
to be split over a 32-bit boundary. 

So it would leave a gap and start 
the short in the next 32-bit word? 

Yes. 

Does that mean each field takes 
up a whole word? 

No. The computer leaves gaps only 
to prevent fields from splitting across word 
boundaries. If it can fit several fields into a 
single word, it will. 


Why does the computer care so 
much about word boundaries? 

It will read complete words from the 
memory. If a field was split across more 
than one word, the CPU would have to read 
several locations and somehow stitch the 
value together. 

And that’d be slow? 

That’d be slow. 

In languages like Java, if I assign 
an object to a variable, it doesn’t copy 
the object, it just copies a reference. 

Why is it different in C? 

In C, a//assignments copy data. If 
you want to copy a reference to a piece of 
data, you should assign a pointer. 


l，m really confused about 
struct names. What’s the struct 
name and what’s the alias? 

The struct name is the word that 
follows the struct keyword. If you write 

struct peter_parker { . . . }, 

then the name is peter—parker, and 
when you create variables, you would say 

struct peter_parker x. 

And the alias? 

Sometimes you don’t want to keep 
using the struct keyword when you 
declare variables, so typedef allows you 
to create a single word alias. In typedef 
struct peter_parker { . . . } 
spider_man;, spider_man is 
the alias. 

So what’s an anonymous 
struct? 

One without a name. So typedef 
struct { . . . } spider_man; 
has an alias of spider—man, but no 
name. Most of the time, if you create an 
alias, you don’t need a name. 
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struct updates 


How do you update a struct? 


A struct is really just a bundle of variables, grouped together and 
treated like a single piece of data. You’ve already seen how to create 
a struct object, and how to access its values using dot notation. 
But how do you change the value of a struct that already exists? 
Well, you can change the fields just like any other variable: 


This Beales a sWi^V fish snappy 


{"Snappy", "piranha", 69, 4}; 


This sets i\\t value o-f printf ("Hello %s\n n ' snappy.name) ;<^This veads i\\t value i\\t name -field- 
七 he ^icld. snappy. teeth = 68;^ Ou^l Looks like Snappy bit h 舦 d. 


That means if you look at this piece of code, you should be able to 
work out what it does, right? 

^include <stdio.h> 


typedef struct { 
const char *name; 
const char ^species; 
int age; 

} turtle; 


void happy birthday(turtle t) 


t.age = t.age + 1 ； 

printf("Happy Birthday %s! You are now %i years old!\n n , 
t.name, t.age); 


int main() 

{ 

turtle myrtle = {"Myrtle ", "Leatherback sea turtle ", 99}; 
happy—birthday(myrtle); 

printf ("%s's age is now %i\n n , myrtle.name, myrtle.age); 
return 0; 


But there’s something odd about this code... 


Myrtle turtle 
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TesT DriVq 


This is what happens when you compile and run the code. 


IVTF???? 


File Edit Window Help ILikeTurtles 


> gcc turtle.c -o turtle && ./turtle 

Happy Birthday Myrtle! You are now 100 years old! 
Myrtle's age is now 99 

> 


iVidkcd 

Tu\rtlc 

Fed 


Something weird has happened. 

The code creates a new struct and then passes it to a function 
that was supposed to increase the value of one of the fields by 1. 
And that’s exactly what the code did .. .at least, for a while. 

Inside the happy—birthday () function, the age field was 
updated, and you know that it worked because the printf () 
function displayed the new increased age value. But that’s when 
the weird thing happened. Even though the age was updated by 
the function, when the code returned to the main () function, 
the age seemed to reset itself. 





This code is doing something weird. But you’ve already been 
given enough information to tell you exactly what happened. 
Can you work out what it is? 
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too many turtles 


The code is cloning the turtle 

Let’s take a closer look at the code that called the 
happy—birthday () function: 

void happy birthday(turtle t) 


This is the tu\rtlc that wc av-c 
-fco "the -Puhdtioh. 

… V 

happy—birthday(myrtle); 

The myrtle s*brud 七 Will be 

In C，parameters are passed to functions by value. That Copied 'to "tVis pav-aw'C'tcv- 

means that when you call a function, the values you pass into 
it are assigned to the parameters. So in this code, it’s almost as 
if you had written something like this: 


Wken you assign 
a struct，its 
values get copied 
to tke new struct. 


turtle t = myrtle; 


But remember, when you assign structs in G, the values 
are copied. When you call the function, the parameter t 
will contain a copy of the myrtle struct. It’s as if the 

function has a clone of the original turtle. So the code 
inside the function does update the age of the turtle, but it’s 
a different turtle. 

What happens when the function returns? The t parameter 
disappears, and the rest of the code in main () uses the 
myrtle struct. But the value of myrtle was never 
changed by the code. It was always a completely separate 
piece of data. 

So what do you do if you want pass a struct 
to a function that needs to update it? 


This is Myirtl 匕 .. 




… but heir t\o)r\t is scht 

"to "the *fuh 匕 "tioh. 



Turtle 


238 


Chapter 5 









structs, unions, and bitfields 


You need a poiwtcr to the struct 

When you passed a variable to the scanf () function, you couldn’t 
pass the variable itself to scanf (); you had to pass a pointer: 

scanf( n %f", Slength of run); 


Why did you do that? Because if you tell the scanf () function 
where the variable lives in memory, then the function will be able to 
update the data stored at that place in memory, which means it can 
update the variable. 

And you can do just the same with structs. If you want a function 
to update a struct variable, you can’t just pass the struct as 
a parameter because that will simply send a copy of the data to the 
function. Instead, you can pass the address of the struct: 


void happy 一 birthday (turtle *t) 丁 W|S mca ⑽ w S owCC mc is <xo'm(\ b> 


me d *to 


a 


aom^ tx 
s*brudt 


by \ address is a fo'm-tev-. 


This mcahs you will pass the address o( 
"the ^y\rtlc "to "the -Puh^ioh. 

… 心 

happy birthday(&myrtie); 


See if you can figure out what expression needs to fit into each 
of the gaps in this new version of the happy—birthday () 
function. 

Be careful. Don’t forget that t is now a pointer variable. 

void happy—birthday(turtle *t) 

{ 

• • age =.• age + 1 ； 

printf("Happy Birthday %s! You are now %i years old!\n", 

.name, .age); 


Of^l^rpen your pencil 
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this is the age of the turtle 

- %Jharpen your pencil 

Solution 


You were to figure out what expression needs to fit into each 
of the gaps in this new version of the happy_birthday () 
function. 


void happy birthday(turtle *t) 

— ^ 






… 通 . .•age =. .…㈣ .. .age + 1 ； 
printf("Happy Birthday %s! You are now %i years old!\n", 

( 十七 ) .name, ( 决七） • age); 

The pa\rc^-thcscs avc v-cally 
The to At will bv-cak y/i 七 hout "them. 


(*t).agc vs. *t.age 

So why did you need to make sure that was wrapped in 
parentheses? It’s because the two expressions, (*t) • age 
and *t • age, are very different. 


I am the age 
of the turtle 
pointed to by t. 


O 


-b d fo'mW -to a 
•turtle styruti 如七 Wis 
is i\\t ay Ulc. 


(*t).age 〆 


So the expression *t. age is really the same as * ( t. age). 
Think about that expression for a moment. It means “the 
contents of the memory location given by t. age.” But 
t. age isn’t a memory location. 


I am the contents of 
the memory location 
given by t.age. 


O 




t is a poihtcv -fco d 
stirudi thch this 
CXpircssioh is w\roh0. 


So be careful with your parentheses when 
using structs — parentheses really matter. 
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Tqst DriVQ 


Let’s check if you got around the bug: 


File Edit Window Help ILikeTurtles 


> gcc happy 一 birthday 一 turtle 一 works•c -o happy 一 birthday—turtle 一 works 
Happy Birthday Myrtle! You are now 100 years old! 

Myrtle's age is now 100 

> 


That’s great. The function now works. 

By passing a pointer to the struct, you allowed the function 
to update the original data rather than taking a local copy. 


I can see how the new code works. But the 
stuff about parentheses and * notation doesiVt 
make the code all that readable. I wonder if 
there's something that would help with that. 


Yes, there is another struct pointer notation 
that is more readable. 

Because you need to be careful to use parentheses in the right 
way when you’re dealing with pointers, the inventors of the G 
language came up with a simpler and easier-to-read piece of 
syntax. These two expressions mean the same thing: 


(*t).age 


t->age 



These *t>wo 七 he samC- 


So, t->age means, “The age field in the struct that t 
points to,” That means you can also write the function like this: 

void happy birthday(turtle *a) 


a->age — a->age 


t->age 

means 


(沣 t).age 









printf("Happy Birthday %s! You are now %i years old \\n'\ 


a->name f 


a->age); 


you are here ► 
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crack safe 



§a 私 Cwc 娜 - 

Shhh...it’s late at night in the bank vault. Can you spin the correct combination to crack the 
safe? Study these pieces of code and then see if you can find the correct combination that 
will allow you to get to the gold. Be careful! There’s a swag type and a swag field. 


You Tittd *to 
tv-atk *tWis 















r - * . - v 负 • ' . 




_ . 




，• _ n-w c* 

#include 

<stdio.h> 

typedef 

struct 

{ 

const 

char * 

description; 

float 

value; 


} swag; 



typedef 

struct 


* swag * 

swag; 


const 

char * 

sequence; 

} combination; 


| 

typedef 

struct 

{ 

combination 

numbers; 

const 

char *make; 

} safe; 
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structs, unions, and bitfields 


The bank created its safe like this: 



What combination will get you to the string "GOLD !”？ Select one symbol or word from each column to 
assemble the expression. 




Dumb Quest? 


9ns 


Why are values copied to parameter variables? 

The computer will pass values to a function by assigning 
values to the function's parameters. And all assignments copy 
values. 


Why isn’t *t. age just read as (*t) . age? 


Because the computer evaluates the dot operator before it 
evaluates the *. 


you are here ► 
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safe cracked 



§a 辟 CR3 轉 SoivtiPH 


Shhh."it’s late at night in the bank vault. You were to spin the correct combination to crack 
the safe. You needed to study these pieces of code and then find the correct combination 
that would allow you to get to the gold. 


















#include 

<stdio.h> 

typedef 

struct 

{ 

const 

char * 

description; 

float 

value; 


} swag; 



typedef 

struct 


swag * 

swag; 


const 

char * 

sequence; 

} combination; 


typedef 

struct 

{ 

combination 

numbers; 

const 

char *make; 

} safe; 




w 















244 Chapter 5 



























structs, unions, and bitfields 


The bank created its safe like this: 


swag gold 

={"GOLD!' 

▼, 1000000 . 

0 }； 


combination numbers 

— {&gold. 

"6502"}; 


safe s — 

{numbers , ’ 

'RAMACON250 

’▼}; 



What combination will get you to the string "GOLD !”？ You were to select one symbol or word from each 
column to assemble the expression. 



So you ddh display y>ld m sa-fc wi*th ： 


.%s\h”, s.humbers.sy/ag — >desdrip*tioh)j 


BULLET POINTS - 

■ When you call a function, the values 
are copied to the parameter variables. 

■ You can create pointers to structs, 
just like any other type. 


■ pointer->f ield is the same as 

(★pointer) . field. 

■ The -> notation cuts down on 
parentheses and makes the code 
more readable. 


you are here ► 
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different data types 


Sometimes the same type of thing needs different types of data 

structs enable you to model more complex things from the real 
world. But there are pieces of data that don’t have a single data type: 





m-teyv- 
Floatmg poiivt 


Floatm^ fom 七 



/\|| o-f dcs^ifec a 


So if you want to record, say, a quantity of something, and that 
quantity might be a count, a weight, or a volume, how would you 
do that? Well, you could create several fields with a struct, like this: 


typedef struct { 


short count; 
float weight; 
float volume; 


} fruit; 

But there are a few reasons why this is not a good idea: 


o 

o 

o 


It will take up more space in memory. 
Someone might set more than one value. 
There's nothing called ''quantity/* 


It would be really useful if you could specify something called 
quantity in a data type and then decide for each particular piece 
of data whether you are going to record a count, a weight, or a 
volume against it. 

In C, you can do just that by using a union. 
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structs, unions, and bitfields 


A movi lets you reuse memory space 


Every time you create an instance of a struct, the computer 
will lay out the fields in memory, one after the other: 


This is a dhav- po*m*tcv 
*to 七 he 


This is sf 把 c ay 舡扣 


char *name int age float weight 


This 's a -float io 

寸一 s *to\rc the weight 


\ 


Y 


7 


Dog d 


Biff' 2, 98.5}; 


A union is different. A union will use the space for just one 
of the fields in its definition. So, if you have a union called 
quantity, with fields called count, weight, and volume, 
the computer will give the union enough space for its largest 
field, and then leave it up to you which value you will store in 
there. Whether you set the count, weight, or volume field, 
the data will go into the same space in memory: 


quantity (might be a float or a short) 


A uhioh looks like a s-tvu^i bu-t 
|七 uses -the Uhioh keyword. 


Y 

typedef union { 


|-f a -float takes \ by-tes, a^d a sho\rt takes 
Z, 七 his spate will be ^ bytes lo. 


short count; 
py i float weight; 
o( -fields Will be v float volume ; 



s*bovcd ^ same 


} quantity; 


These a\rc all diWc …七 ^7? cs, 
W 七 tV^cyVc all <\ua^cs. 


Mcasuvc juidc- 


Couir>*t 


l/Vlcigh jv-apes. 


you are here ► 
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union 


How do you use a union? 

When you declare a union variable, there are a few ways 
of setting its value. 

CS9 style for the first field 

If the union is going to store a value for the first field, 
then you can use G89 notation. To give the union a 
value for its first field, just wrap the value in braces: 

quantity q = {4}; ^ - TK'is 切 

is a touy\*t ^T- 

Pesignated initializers set other values 

A designated initializer sets a union field value by 
name, like this: 

, .,.- ，-, will set the 

quantity q = { . weight=l. 5}; tz n n l- 

u^ior\ joV" a irloat-mj— 

pom*t value- 



— Dumb Questi9ns — 

Why is a union always set to the 
size of the largest field? 

The computer needs to make sure that 
a union is always the same size. The only 
way it can do that is by making sure it is large 
enough to contain any of the fields. 

^^,-Why does the C89 notation only set 
the first field? Why not set it to the first 
float if I pass it a float value? 

To avoid ambiguity. If you had, say, a 
float and a double field, should the 
computer store {2.1} as a float ora 
double? By always storing the value in the 
first field, you know exactly how the data will 
be initialized. 


Set the value with dot notation 

The third way of setting a union value is by creating the 
variable on one line, and setting a field value on another 
line: 


quantity q; 
q.volume = 3.7; 


Remember: whichever way you set the union’s value, 

there will only ever be one piece of data stored. The 
union just gives you a way of creating a variable that 
supports several different data types. 



The Polite f 0 

Designated initializers allow 
you to set struct and union 
fields by name and are part of 
the C99 C standard. They are 
supported by most modern 
compilers, but be careful if 
you are using some variant of 
the C language. For example, 
Objective C supports 
designated initializers, but 
C++ does not. 
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structs, unions, and bitfields 


Those designated initializers look like 
they could be useful for structs as well. 
I wonder if I can use them there. 


Yes, designated initializers can be used to set the 
initial values of fields in structs as well. 

They can be very useful if you have a struct that contains a large 
number of fields and you initially just want to set a few of them. It’s 
also a good way of making your code more readable: 

typedef struct { 

const char *color; 

int gears; TW»s Will sc*b 

七七 Wds, 

int height; XscU^^^ia. 

} bike; 

bike b = {.height=17, .gears=21}; 


unions are often used with structs 



Once you’ve created a union, you’ve created a new data type. 
That means you can use its values anywhere you would use 
another data type like an int or a struct. For example, you 
can combine them with structs: 


typedef struct { 
const char *name; 
const char ^country; 
quantity amount; 

} fruit order; 


^ou can access the values in the struct/union 
combination using the dot or -> notation you used before: 


youVc us'm^ s double 
dcs*i^a*tcd 

.dmou^i -fov -the By\A 

-fov* 七 he amount 


I Vs .amou^-b because thaVs the the s*t\ru^*t <\ua^*ti*ty vav-iablc- 

fruit 一 order apples = {"apples ", "England ", .amount.weight=4.2}; 

printf("This order contains %2.2f lbs of %s\n ", apples.amount.weight , apples.name); 

This yn|| 'This o\rdcv- dohtaihs 午 .ZO lbs o*f applcs. w 


you are here ► 
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mixers mixed 



iHixdp-UP 


It’s Margarita Night at the Head First Lounge, but after one too many samples, it looks like the guys 
have mixed up their recipes. See if you can find the matching code fragments for the different 
margarita mixes. 

Here are the basic ingredients: 


typedef union { 
float lemon; 


int lime—pieces; 
} lemon lime; 


typedef struct { 
float tequila; 
float cointreau; 
lemon_lime citrus; 
} margarita; 

Here are the different margaritas: 
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structs, unions, and bitfields 


And finally, here are the different mixes and the drink recipes they produce. Which of the margaritas need to be 
added to these pieces of code to generate the correct recipes? 






BE . C^llei 

One of tiiese pieces (J code compiles ； tire 
odier doesn’t. Your job is to play like 
you’re the compiler and say Wch one 

compiles, and^ytiie odier 
one doesn’t. 


margarita m = {2.0, 1.0, {0.5}}; 


margarita m; 
m = {2.0, 1.0, {0.5}}; 


you are here ► 
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mixed mixers unmixed 



祕 鄉 -UP 祕 站略 S^>LjitiPH - 

It’s Margarita Night at the Head First Lounge, but after one too many samples, it looks like the guys 
have mixed up their recipes. You were to find the matching code fragments for the different margarita 
mixes. 

Here are the basic ingredients: 

typedef union { 
float lemon; 


int lime—pieces; 
} lemon lime; 


typedef struct { 
float tequila; 
float cointreau; 
lemon_lime citrus; 
} margarita; 

Here are the different margaritas: 



UoY\t o( these 
I'mes y/ds used- 
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And finally, here are the different mixes and the drink recipes they produce. Which of the margaritas need to be 
added to these pieces of code to generate the correct recipes? 


margarita m = {2.0, 1.0 ， {2}}; 




prinxf ( n %2.If measures of tequila\n%2.If measures of cointreau\n%2.If 
measures of juice\n n , m.tequila, m.cointreau, m.citrus.lemon); 


2.0 measures of tequila 
1.0 measures of cointreau 
2.0 measures of juice 


margarita m = {2.0, 1.0, {0.5}} 




printf("%2.If measures of tequila\n%2.If measures of cointreau\n%2.If 
measures of j uice\n f, , m.tequila, m. cointreau f m. citrus . lemon); 


2.0 measures of tequila 
1.0 measures of cointreau 
0.5 measures of juice 


margarita m = {2.0, 1.0, {•lime pieces=l}}; 


printf ( n %2.If measures of tequila\n%2.If measures of cointreau\n%i pieces 
of lime\n ", m.tequila, m.cointreau A m.citrus.lime pieces); 


2.0 measures of tequila 
1.0 measures of cointreau 
1 pieces of lime 


I 



BEfk 




One of tiiese pieces (J code compiles ； tire 
# odier doesn’t. Your job is to play like 
v \ you’re tire compiler and say one 



margarita m = {2.0, 1.0, {0.5}}; 

^*This ohC dor^pilcs pcv--fcd*tly. 

adtually jus*t o-P -the dv'mks above/ 

margarita m; 

m = {2.0, 1.0, {0.5}}; 


compiles, and odier 刀 m = 

° ne d 0eSn t •丁 w docs^-b Compile because y/ill o^ly k^ov/ 

七 ha 七 [2- 0) 10, {0.^}} vcfvcsc^*b a stvu^*b i-f used oy\ -tlic 
same I'me 侁 at a *.s Atdartd. I/Vb 心⑼ a strait 

l*mc, i\\t tWmks it’s 扣 avvdy. you are here ► 
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unions and type 


Hey, wait a minute... Youre setting all these 
different values with all these different types 
and youre storing them in the same place in 
memory... How do I know if I stored a float in there 
once Ive stored it? Whafs to stop me from 
reading it as a short or something??? Hello? 


That’s a really good point: you can store lots of 
possible values in a union, but you have no way 
of knowing what type it was once it’s stored. 

The compiler won’t be able to keep track of the fields that are set 
and read in a union, so there’s nothing to stop us setting one field 
and reading another. Is that a problem? Sometimes it can be a 

BIG PROBLEM 


^include <stdio.h> 
typedef union { 
float weight; 
int count; 

} cupcake; 


By ^'isiakc, the 

has 处七 the 
WCighi hot ihc doUhi 


int main () 

{ 、 

cupcake order = {2}; 

printf("Cupcakes quantity : 
return 0; 

} 


SV^c set 
Ac’s 

%i\n n , order.count); 



This is 七七 he fvoyam did- 


File Edit Window Help 


> gcc badunion.c -o badunion && ./badunion 
Cupcakes quantity : 1073741824 


a lo*t dupdakes... 


You need some way, then, of keeping track of the 
values we’ve stored in a union. One trick that some G 
coders use is to create an enum. 
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An enum variable stores a symbol 

Sometimes you don’t want to store a number or a piece 
of text. Instead, you want to store something from a list of 
symbols. If you want to record a day of the week, you only 
want to store MONDAY, TUESDAY, WEDNESDAY, etc. You 
don’t need to store the text, because there are only ever going 
to be seven different values to choose from. 

That’s why enums were invented. 

enum lets you create a list of symbols, like this: 


Possible £-olo\rs s \ 

ih youv- chur^. enum colors 


^J\\t values are scf av-a*tcd by dommas. 

{RED, GREEN, PUCE}; 

You dould have the type a pvopcv- y/ith iypcdc-f. 


Any variable that is defined with a type of enum colors 
can then only be set to one of the keywords in the list. So you 
might define an enum colors variable like this: 

enum colors favorite = PUCE; 

Under the covers, the computer will just assign numbers to 
each of the symbols in your list, and the enum will just store a 
number. But you don’t need to worry about what the numbers 
are; your G code can just refer to the symbols. That’ll make 
your code easier to read, and it will prevent storing values like 
REB or PUSE: 


. 

structs and 

unions 

separate 

Watch it! items with 

semicolons (;)， 
but enums use commas. 


The y/ill spo 七七 ha 七七 his is 

⑽七 a Icjal value, so i-t wo " 七 Compile. 


Nope; I*m not 
compiling that; 
ifs not on my list. 


enum colors favorite = PUSE 


So that’s how enums work, but how do they 
help you keep track of unions? Let’s look at 
an example... 



you are here ► 


255 










code magnets 


Code Magnets 



Because you can create new data types with enums, you can store them inside 
structs and unions. In this program, an enum is being used to track the kinds of 
quantities being stored. Do you think you can work out where the missing pieces of 
code go? 


^include <stdio.h> 

typedef enum { 

COUNT, POUNDS, PINTS 
} unit_of_measure; 

typedef union { 
short count; 
float weight; 
float volume; 

} quantity; 

typedef struct { 
const char ^name; 
const char ^country; 
quantity amount; 
unit_of_measure units; 

} fruit_order; 

void display(fruit_order order) 

{ 

printf ("This order contains ▼'); 

if ( == PINTS) 


printf("%2.2f pints of %s\n ", order.amount. 


order.name) 
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else if ( —— ) 

printf ("%2.2f lbs of %s\n ", order.amount.weight , order.name); 
else 

printf ("%i %s\n n , order.amount. , order.name); 

} 

int main() 

{ 

fruit_order apples = {"apples ", "England ", . amount.count=144, }; 

fruit_order strawberries = {"strawberries ", "Spain ", .amount. =17.6, POUNDS}; 

fruit_order oj = {"orange juice ", M U.S.A.", .amount.volume=10.5 , }; 

display(apples); 

display(strawberries); 

display(oj); 

return 0; 



you are here ► 
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magnets solved 


Code Magnets Solution 



Because you can create new data types with enums, you can store them inside 
structs and unions. In this program, an enum is being used to track the kinds of 
quantities being stored. Were you able to work out where the missing pieces of code 
go? 


^include <stdio.h> 

typedef enum { 

COUNT, POUNDS, PINTS 
} unit_of_measure; 

typedef union { 
short count; 
float weight; 
float volume; 

} quantity; 

typedef struct { 
const char *name; 
const char ^country; 
quantity amount; 
unit_of_measure units; 

} fruit_order; 

void display(fruit_order order) 

{ 

printf ("This order contains ▼'); 


if ( 



PINTS) 


printf ("%2.2f pints of %s\n n , order.amount. 



, order.name) 


258 


Chapter 5 













structs, unions, and bitfields 




else if ( 

printf ("%2.2f lbs of %s\n ", order.amount.weight , order.name) 
else 


printf ("%i %s\n n , order.amount. 



, order.name) 


int main() 

{ 

fruit order apples 


apples ", "England ", .amount.count=144, 


|~COUNT I 


fruit order strawberries = {"strawberries ", "Spain ", .amount. 



17.6, POUNDS} 


fruit—order oj = {"orange juice ", 

display(apples); 

display(strawberries); 

display(oj); 

return 0; 


M U.S.A.", .amount.volume=10.5 



W\\cy\ you \ruh pyoyam, you yt this: 


File Edit Window Help 


> gcc emamtest.c 一 o enumtest 

This order contains 144 apples 

This order contains 17.60 lbs of strawberries 

This order contains 10.50 pints of orange juice 


you are here ► 
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overheard 



union ： ...so I said to the code, “Hey ， look. I don’t care 
if you gave me a float or not. You asked for an int. 
You got an int.” 

Struct ： Dude, that was totally uncalled for. 

union ： That’s what I said. It’s totally uncalled for. 

Struct ： Everyone knows you only have one storage 
location. 

union ： Exactly. Everything is one. I’m, like, Zen that 
way... 

enum ： What happened, dude? 

struct ： Shut up, enum. I mean, the guy was crossing 
the line. 

union ： I mean, if he had just left a record. You know, 
said, I stored this as an int. It just needed an enum or 
something. 

enum ： You want me to do what? 
struct ： Shut up, enum. 

union ： I mean, if he’d wanted to store several things at 
once, he should have called you, am I right? 

Struct ： Order. That’s what these people don’t grasp. 

enum ： Ordering what? 

Struct ： Separation and sequencing. I keep several 
things alongside each other. All at the same time, dude. 

union ： That’s just my point. 

struct ： All. At. The. Same. Time. 

enum ： (Pause) So has there been a problem? 

union ： Please, enum? I mean these people just need to 


make a decision. Wanna store several things, use you. 

But store just one thing with different possible types? 
Dude’s your man. 

Struct ： I’m calling him. 

union ： Hey, wait... 

enum ： Who’s he calling, dude? 

struct/union: Shut up, enum. 

union ： Look, let’s not cause any more problems here. 

struct ： Hello? Gould I speak to the Bluetooth service, 
please? 

union ： Hey, let’s just think about this. 

Struct ： What do you mean, he’ll give me a callback? 

union ： I’m just. This doesn’t seem like a good idea. 

Struct ： No, let me leave you a message, my friend. 

union ： Please, just put the phone down. 

enum ： Who’s on the phone, dude? 

struct ： Be quiet, enum. Can’t you see I’m on the phone 
here? Listen, you just tell him that if he wants to store a 
float and an int, he needs to come see me. Or I’m 
going to come see him. Understand me? Hello? Hello? 

union ： Easy, man. Just try to keep calm. 

struct ： On hold? They put me on A *& A ing hold! 

union ： They what? Pass me the phone... Oh...that … 
man. The Eagles! I hate the Eagles... 

enum ： So if you pack your fields, is that why you’re so 
fat? 

Struct ： You are entering a world of pain, my friend. 
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Sometimes you want control at the bit level 


Let’s say you need a struct that will contain a lot of yes/no values. 
You could create the struct with a series of shorts or ints: 


typedef 

short 

short 

short 

short 

拳馨參 

} synth; 


struct { 
low_pass_vcf; 
filter_coupler; 
reverb; 
sequential; 


o-f -these -f ields 
v/'ill I -fov* 

*tv*uc ov 0 -fov -false- 



Thcv-c avc a lo-t rwo\rc -fields -that -follow ih 
-f ield Will use 你 brts. 


IS. 



0000000000000001 

0000000000000001 

0000000000000001 

參 •參 


And that would work. The problem? The short fields will take up 
a lot more space than the single bit that you need for true/false 
values. It’s wasteful. It would be much better if you could create a 
struct that could hold a sequence of single bits for the values. 

That’s why bitfields were created. 

f 濉 Gee| Binary Digits - 

converting binary and decimal? The good news is 
that you can convert hex to binary one digit at a 
time: 

0x54 

This is 〆 \ < This is 千. 

0101 0100 

Each hexadecimal digit matches a binary digit of 
length 4. All you need to learn are the binary patterns 
for the numbers 0-15, and you will soon be able to 
convert binary to hex and back again in your head 
within seconds. 


When you’re dealing with binary value, it would be 
great if you had some way of specifying the 1 s and 0s 
in a literal, like: 

int x = 01010100; 

Unfortunately, C doesn’t support binary literals, but 

it does support hexadecimal literals. Every time 

C sees a number beginning with Ox, it treats the 

number as base 16 : , , , 

^This is v>o*t dcdirw3l 

int x = 0x54; 

But how do you convert back and forth between 
hexadecimal and binary? And is it any easier than 



you are here ► 
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take care of your bits 


Pitfidds store a custom number of bits 

A bitfield lets you specify how many bits an individual 
field will store. For example, you could write your 
struct like this: 


typedef struct { 


E 此 h -field should 
be ah Uhsighcd iht. 


unsigned int 
unsigned int 
unsigned int 
unsigned int 


low_j>ass_vcf : 1 ; 

filter_coupler:l; mca , s ^ icld V ,ll 

or\Yf use I b*rt o( stov-a^C- 

sequential : 1; 


reverb : 1 


By us'm^ 


eddk 


} synth; 


b'rt-f iclds, you make 

Id -takes up oy>ly OY\t brt. 


suve 




If you have a sequence of bitfields, the computer can 
squash them together to save space. So if you have 
eight single-bit bitfields, the computer can store them in a 
single byte. 


Let’s see how how good you are at using 
bitfields. 



Bitfields can save 
space if they are 
collected together 
in a struct. 


But if the compiler 
finds a single bitfield on its own, it 
might still have to pad it out to the 
size of a word. That’s why bitfields 
are usually grouped together. 


IJow many bits do I need? 

Bitfields can be used to store a sequence of true/false values, but they’re 
also useful for other short-range values, like months of the year. If you want 
to store a month number in a struct, you know it will have a value of, 
say, 0-11. You can store those values in 4 bits. Why? Because 4 bits let you 
store 0-15, but 3 bits only store 0-7. 


unsigned int month no:4; 
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structs, unions, and bitfields 



Back at the Head First Aquarium, they’re creating a customer satisfaction survey. Let’s see if you 
can use bitfields to create a matching struct. 






Aquarium Questionnaire 


Is this your first visit? 


Will you come again 

Number of fingers lost in the piranha tank; 

Did you lose a child in the shark exhibit? 

How many days a week would you visit if you could? 


typedef struct 
unsigned int 
unsigned int 
unsigned int 
unsigned int 
unsigned int 


^ You r\tt& *to dcdidc 

( Koy/ bits bo use. 

first—visit: ; 

come_again : ; 

fingers—lost: ; 

shark_attack : ; 

days a week : ; 


} survey; 
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exercise so/vec/ 


學 s 

SoLyti 


RctSe 

oh 


Back at the Head First Aquarium, they’re creating a customer satisfaction survey. You were to 
use bitfields to create a matching struct. 






Aquarium Questionnaire 


Is this your first visit? 


Will you come again 

Number of fingers lost in the piranha tank; 

Did you lose a child in the shark exhibit? 

How many days a week would you visit if you could? 


typedef struct { 

unsigned int first—visit: I ; - ^ I b'i*t t^r\ s*tovc Z 

unsigned int come—again: | ; values ： *t\ruc/*falsc. 

unsigned int fingers—lost : "… 肀…； 午 bits 辦 heeded 
unsigned int shark—attack: | ; s "tov-c up -to lO. 

unsigned int days_a_week : ^ ; 

} survey; ^ - Z bi*U s*tovc 

v>urwbcv-s uf *to "/• 
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structs, unions, and bitfields 


tKereiare no 

Dumb Qi] 


Questions 


Why doesn’t C support binary 
literals? 

Because they take up a lot of space, 
and it’s usually more efficient to write hex 
values. 

Why do I need 4 bits to store a 
value up to 10? 

Four bits can store values from 0 to 
binary 1111, which is 15. But 3 bits can only 
store values up to binary 111, which is 7. 


So what if I try to put the value 9 
into a 3-bit field? 

The computer will store a value of 1 
in it, because 9 is 1001 in binary, so the 
computer transfers 001. 

Are bitfields really just used to 
save space? 

No. They’re important if you need to 
read low-level binary information. 


Such as? 


If you’re reading or writing some sort 
of custom binary file. 


BULLET POINTS — 

■ A union allows you to store 
different data types in the same 
memory location. 

■ A designated initializer sets a field 


■ The compiler will let you store 
one field in a union and read a 
completely different field. But be 
careful! This can cause bugs. 


value by name. 

Designated initializers are part of 
the C99 standard. They are not 
supported in C++. 

If you declare a union with a value 
in {braces}, it will be stored with the 
type of the first field. 


■ enums store symbols. 

■ Bitfields allow you to store a field with 
a custom number of bits. 

■ Bitfields should be declared as 

unsigned int. 
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c toolbox 


Your C Toolbox 

You’ve got Chapter 5 under 
your belt，and now you’ve 
added structs, unions，and 
bitfields to your toolbox. For a 
complete list of tooltips in the book ， 
see Appendix ii. 



J\ sbr^ 

60 ^Wes da^ 

^ You 乙 

You caY\ v-cad 
s*tv*u6 七 -f *clds 
v/i*t^ do*b 

y\o*tat»oy\. 

ihrtializjc 

t ~' 

s*brud*ts wi£h 


Way, like, 


^o-taiioh}. 



. 1 ! tveaU a. 
aWas W a 
data 


一 > ho*t3*tioh 
lets you easily 
update -fields 
usihg a s£\rudi 
poih£c\r. 


uhiohS tBv\ hold 

di 以 Weh 七 daia 

types *m oy\C 
loda*tior\. 


Dcsijhaicd 
ihitialiic\rs let 
you Sti sbrui J 

dhd uhioh -fields 
by hame. I 


\ti ^ 

P A sc*t 


Cftdfct a 

0 Jf S^^°' s 




Bi-t-f iclds 5»vc 


you doy\*tv*ol 
OVCV" *tVlC 


brts stored a 
s*tv-ud*t* 
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6 dqta structures and dynamic memory 


參 Building bridges ♦ 



Sometimes, a single struct is simply not enough. 

To model complex data requirements, you often need to link structs together. In 
this chapter, you’ll see how to use struct pointers to connect custom data types into 
large, complex data structures. You’ll explore key principles by creating linked lists. 
You’ll also see how to make your data structures cope with flexible amounts of data by 
dynamically allocating memory on the heap, and freeing it up when you’re done. And if 
good housekeeping becomes tricky, you’ll also learn how valgrind can help. 


this is a new chapter 
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flexible data 


Vo you need flexible storage? 

You’ve looked at the different kinds of data that you can store in G, and 
you’ve also seen how you can store multiple pieces of data in an array. 
But sometimes you need to be a little more flexible. 

Imagine you’re running a travel company that arranges flying tours 
through the islands. Each tour contains a sequence of short flights from 
one island to the next. For each of those islands, you will need to record 
a few pieces of information, such as the name of the island and the 
hours that its airport is open. So how would you record that? 

You could create a struct to represent a single island: 



C flakes bc*tv/ccir\ 

islands. 


typedef struct { 
char ^name; 
char *opens; 
char ^closes; 

} island; 


Now if a tour passes through a sequence of islands, that means you’ll need 
to record a list of islands, and you can do that with an array of islands: 



But there’s a problem. Arrays are fixed length, which means they’re not 
very flexible. You can use one if you know exactly how long a tour will be. 
But what if you need to change the tour? What if you want to add an extra 
destination to the middle of the tour? 


To store a flexible amount of data, you need something 
more extensible than an array. You need a linked list. 
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Linked lists are like chains of data 

A linked list is an example of an abstract data structure. 

It’s called an abstract data structure because a linked list is 
general., it can be used to store a lot of different kinds of data. 

To understand how a linked list works, think back to our tour 
company. A linked list stores a piece of data, and a link to 
another piece of data. 



In a linked list, as long as you know where the list starts, you can 
travel along the list of links, from one of piece of data to the next, 
until you reach the end of the list. Using a pencil, change the list 
so that the tour includes a trip to Skull Island between Craggy 
Island and Isla Nublar. 


rpen your pencil 


/ou a\rc s-fco\rir>g a ficdc o( 
data -Pov- eddh island- 


TV»"»s is a Imk *to 
rtcx.-t ^\ttt o-f data 




Craggy 


you are here ► 269 









tour changed 


parpen your pencil 

Solution 


In a linked list, as long as you know where the list starts, you 
can travel along the list of links, from one of piece of data to the 
next, until you reach the end of the list. Using a pencil, you were 
to change the list so that the tour includes a trip to Skull Island 
between Craggy Island and Isla Nublar. 



A^nity 



u needed *to 

create a 



Craggy 


七 he -flijK-b 
-fvom Ora 於 / *to 
|sla Nublav-. 



V^u heeded io 

3 hCW 

flight -fr 
Skull io Isis 
HMsr. 

〆 



Shutter 


Isla Nublar 


Linked lists allow inserts 


With just a few changes, you were able to add an extra step 
to the tour. That’s another advantage linked lists have over 
arrays: inserting data is very quick. If you wanted to 
insert a value into the middle of an array, you would have to 
shuffle all the pieces of data that follow it along by one: 


you y/arrted *to msevt 3^ value 

a-f-tev Cv-a^^y Island, youd V^avc -to 你。此 
七 ^ otiicv values a\ov\^ ov\t spade. 


This is ah 


a\r\ray. 


Amity 

Craggy 

Isla Nublar 

Shutter 


So linked lists allow you to store a variable amount of 
data, and they make it simple to add more data. 


A T 

广 hd because sy\ avvay is fixed 

lehgth, you'd lose Shutter Isbhd. 


But how do you create a linked list in C? 
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Create a recursive structure 

Each one of the structs in the list will need to connect to 
the one next to it. A struct that contains a link to another 
struct of the same type is called a recursive structure. 


This is 3 vc^uvsivc 
s-t\rudtu\rc -Po\r av\ island- —^ 




You *to v-cdov-d all the 
usual details -fov the island... 


r 


r 

...but you also heed "to give the 
island a lihk -to the hCX-t island- 


Recursive structures contain pointers to other structures of the 
same type. So if you have a flight schedule for the list of islands 
that you’re going to visit, you can use a recursive structure for 
each island. Let’s look at how that works in more detail: 

\rc^o\rd 

these details 
-Pov tdiCM 
islolhd- 


ma mus-t jive -the si\rudt a 



\s\and avrpor-t 


Kl8m0 ： 


Opens*- 


C\oses- 

i sPm 

Klex-t \s\and* 



Pov cadh islahd> you II also \rc^o\rd the hwt isldhd- 


How do you store a link from one struct to the 
next? With a pointer. That way, the island data will 
contain the address of the next island that we’re 
going to visit. So, whenever our code is at one island, 
it will always be able to hop over to the next island. 

Let’s write some code and start island 
hopping. 


typedef struct island 
char ^name; 
char ^opens; 
char ^closes; 
struct island *next 
} island; 




Voull use 
stv-ihgs -fov 

the 

"times. 

ou s*tove a 
pomtev- *to 七 he 
island m 
s*bru 匕七 . 



Watch it! 


Recursive structures 
need names. 


If you use the typedef 
command, you can normally 
skip giving the struct a proper 
name. But in a recursive structure, you need 
to include a pointer to the same type. C 
syntax won’t let you use the typedef alias ， 
so you need to give the struct a proper 
name. That’s why the struct here is called 
struct island. 
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link islands 


Create islands m C 


Once you have defined an island data type, you can create 
the first set of islands like this: 

island amity = {"Amity ", "09:00", "17:00", NULL}; 
island craggy = {"Craggy ", "09:00", "17:00", NULL}; 

island isla_nublar = { f, Isla Nublar n , n 09:00 n , n 17:00 n , NULL}; 
island shutter = {"Shutter ", n 09:00 n , "17:00", NULL}; 




TWis Codt will trtait island 
s*tvu^*ts -fov islands. 



Did you notice that we originally set the next field in each 
island to NULL? In G, NULL actually has the value 0, but 
it’s set aside specially to pointers to 0. 


Isla Nublar 






and link them together to form a tour 


Once you’ve created each island, you can then 
connect them together: 


amity.next = Scraggy; 
craggy.next = &isla_nublar; 
isla nublar.next = &shutter; 


You have to be careful to set the next field in each island 
to the address of the next island. You’ll use struct 
variables for each of the islands. 


Skutter 


So now you’ve created a complete island tour in G, but what 
if you want to insert an excursion to Skull Island between Isla 
Nublar and Shutter Island? 


Isla Nublar 
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Inserting values iwto the list 


You can insert islands just like you did earlier, by changing the values 
of the pointers between islands: 


TVis Ue Creates 
Skull Island- 


island skull = { 
isla nublar.next 


Skull", 

― &skull 


09:00", n 17:00 n , NULL}; 

^~* This Isla Kublolv- -to Skull. 



In just two lines of code, you’ve inserted a new value into 
the list. If you were using an array, you’d write a lot more 
code to shuffle items along the array. 


skull. next = &shutter; 七 -TVis Skull *to Shutter Island- 


Skutter 


Isla Nublar 


OK, you’ve seen how to create and use linked 
lists. Now let’s try out your new skills... 


C 0c ^ e Magnets 



Oh, no, the code for the display () function was on the fridge door, but 
someone’s mixed up the magnets. Do you think you can reassemble the code? 



void display(island *start) 


island *i = start; 


for (; i 



printf("Name : %s open : %s-%s\n 



Q EEED [null I 


[i->next~| 曰 
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magnets solved 


Code Magnets Solution 


Oh, no, the code for the display () function was on the fridge door, but 
someone’s mixed up the magnets. Were you able to reassemble the code? 



void display(island *start) 

Vo\A doY^i I You y\ttd bo kcc? ' 00 ? m 5 

island V^as ^ value. 


v\ccd any 
c^bra 
todt a-t 
七 he sta\rt 

o( -the 
loop. 


island 


start 





for (; 



printf("Name : %s open : %s-%s\n' 


null I ; i 

I i->name 1 

• • • • I • 


At the Chd of loop, 

skip -to the next island. 






Other languages, like Java, have 
linked lists built in. Does C have any 
data structures? 

C doesn’t really come with any data 
structures built in. You have to create them 
yourself. 

What if I want to use the 700th 
item in a really long list? Do I have to 
start at the first item and then read all 
the way through? 

Yes, you do. 



That’s not very good. I thought a 
linked list was better than an array. 

You shouldn’t think of data structures 
as being better or worse. They are either 
appropriate or inappropriate for what you 
want to use them for. 

So if I want a data structure that 
lets me insert things quickly, I need a 
linked list, but if I want direct access I 
might use an array? 

Exactly. 


You’ve shown a struct that 
contains a pointer to another struct. 
Can a struct contain a whole 
recursive struct inside itself? 

A: No . 

Why not? 

C needs to know the exact amount of 
space a struct will occupy in memory. 

If it allowed full recursive copies of the 
same struct, then one piece of data 
would be a different size than another. 
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Tesr DriVq 


Let’s use the display () function on the linked list of islands 
and compile the code together into a program called tour. 


island amity = {"Amity", n 09:00 n , n 17:00 n , NULL}; 
island craggy = {"Craggy", "09:00", n 17:00 n , NULL}; 

island isla nublar = { n Isla Nublar", 


09:00" 
M 17 : 00 


island shutter = {"Shutter ", "09:00", 
amity.next = Scraggy; 
craggy.next = &isla_nublar; 
isla_nublar.next = &shutter; 

island skull = {"Skull", "09:00", "17:00", NULL}; 


17:00 

NULL} 


NULL}; 


isla nublar.next 


&skull 


skull.next 


&shutter 


display(&amity); 

Excellent. The code creates a linked list of islands, and 
you can insert items with very little work. 

OK, so now that you know the basics of how to work with 
recursive structs and lists, you can move on to the main 
program. You need to read the tour data from a file that 
looks like this: 



I File Edit Window Help GetBiqqerBoat 


> gcc tour.c 一 o tour && ./tour 
Name : Amity 

Open : 09:00-17 : 00 
Name : Craggy 
Open : 09:00-17 : 00 
Name : Isla Nublar 
Open : 09:00-17 : 00 
Name : Skull 
Open : 09:00-17:00 
Name : Shutter 
Open : 09:00-17 : 00 

> 


TV>cv-c W\W 

be some 
move I'mcs 
this. 

The folks at the airline are still creating the file, so you won’t 
know how long it is until runtime. Each line in the file is the 
name of an island. It should be pretty straightforward to turn 
this file into a linked list. Right? 



The Polite - 

The code on this page declares 
a new variable, skull, right in 
the middle of the code. This is 
allowed only in C99 and C11. 

In ANSI C, you need to declare 
all your local variables at the 
top of a function. 
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dynamic storage 




Hmmm... So far, weve used a separate variable 
for each item in the list. But if we don’t know how 
long the file is, how do we know how many variables 
we need? I wonder if theres some way to generate 
new storage when we need it. 



Yes, you need some way to create 
dynamic storage. 

All of the programs you’ve written so far have used 
static storage. Every time you wanted to store something, 
you’ve added a variable to the code. Those variables have 
generally been stored in the stack. Remember: the stack 
is the area of memory set aside for storing local variables. 

So when you created the first four islands, you did it like 
this: 

island amity = {"Amity", "09:00", "17:00", NULL}; 
island craggy = {"Craggy ", n 09:00 n , n 17:00 n , NULL}; 
island isla_nublar = { n Isla Nublar n , n 09:00 n , n 17:00 n , 
island shutter = {"Shutter ", "09:00", n 17:00 n , NULL}; 




NULL}; 


Each island struct needed its own variable. This piece 
of code will always create exactly four islands. If you 
wanted the code to store more than four islands, you 
would need another local variable. That’s fine if you know 
how much data you need to store at compile time, but quite 
often, programs don’t know how much storage they need until 
runtime. If you’re writing a web browser, for instance, you 
won’t know how much data you’ll need to store a web page 
until, well, you read the web page. So G programs need some 
way to tell the operating system that they need a little extra 
storage, at the moment that they need it. 

Programs need dynamic storage. 
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. 




WouldtVt it be dreamy if there were a 
way to allocate as much space as I needed 
with code at runtime? But I know that’s 
just a fantasy... 
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mallocQ 


Use the heap for dynamic storage 

Most of the memory you’ve been using so far has been in the 
stack. The stack is the area of memory that’s used for local 
variables. Each piece of data is stored in a variable, and each 
variable disappears as soon as you leave its function. 

The trouble is, it’s harder to get more storage on the stack at 
runtime, and that’s where the heap comes in. The heap is 
the place where a program stores data that will need to be 
available longer term. It won’t automatically get cleared away, 
so that means it’s the perfect place to store data structures like 
our linked list. You can think of heap storage as being a bit 
like reserving a locker in a locker room. 


First get your memory with mallocO 



r 

Heap s-to\ragc is like savih^ 
valuables ih a lodkcv-. 


Imagine your program suddenly finds it has a large 
amount of data that it needs to store at runtime. This 
is a bit like asking for a large storage locker for the 
data, and in G you do that with a function called 
malloc (). You tell the malloc () function exactly 
how much memory you need, and it asks the operating 
system to set that much memory aside in the heap. The 
malloc () function then returns a pointer to the new 
heap space, a bit like getting a key to the locker. It allows 
you access to the memory, and it can also be used to 
keep track of the storage locker that’s been allocated. 



Tk ^\U0 Uchor, W.II yve you a 

-to s ? adc rn v.ca ? . 








mw 
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ftive the memory back when you're done 

The good news about heap memory is that you can keep hold of it for a 
really long time. The bad news is.. .you can keep hold of it for a really 
long time. 

When you were just using the stack, you didn’t need to worry about 
returning memory; it all happened automatically. Every time you leave a 
function, the local storage is freed from the stack. 

The heap is different. Once you’ve asked for space on the heap, it 
will never be available for anything else until you tell the G Standard 
Library that you’re finished with it. There’s only so much heap memory 
available, so if your code keeps asking for more and more heap space, 
your program will quickly start to develop memory leaks. 

A memory leak happens when a program asks for more and more 
memory without releasing the memory it no longer needs. Memory 
leaks are among the most common bugs in G programs, and they can be 
really hard to track down. 


Tke keap kas 
only a iixect 
amount ol 


storage available, 
so te sure you 
use it wisely. 


Free memory by calling the free!) function 


The malloc () function allocates space and gives you a pointer to it. 
You’ll need to use this pointer to access the data and then, when you’re 
finished with the storage, you need to release the memory using the 
free () function. It’s a bit like handing your locker key back to the 
attendant so that the locker can be reused. 



Every time some part of your code requests heap storage with the 
malloc () function, there should be some other part of your code 
that hands the storage back with the free () function. When 
your program stops running, all of its heap storage will be released 
automatically, but it’s always good practice to explicitly call free () 
on every piece of dynamic memory you’ve created. 


Let’s see how malloc() and free() work. 
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freeQ 


Ask for memory with mallocH... 

The function that asks for memory is called malloc () 
for memory allocation, malloc () takes a single parameter: 
the number of bytes that you need. Most of the time, you 
probably don’t know exactly how much memory you need 
in bytes, so malloc () is almost always used with an 
operator called sizeof, like this: 

#include <stdlib.h> 

i t 〜 v n\C3r\S, w 6 ivc me spade 

malloc (sxzeof (island)) ; sW isUd 


Vou ,eed to Mlude 如 ^ 

-to u\> r^aWocO a^d 


sizeof tells you how many bytes a particular data type 
occupies on your system. It might be a struct, or it could 
be some base data type, like int or double. 


The malloc () function sets aside a chunk of memory 
for you, then returns a pointer containing the start address. 

But what kind of pointer will that be? malloc () actually 

returns a general-purpose pointer^ with type void*. y^*, s “Cveate 

Chough -Pov- ah 

island *p = malloc (sizeof (island)) ; i 山 hi a^d s-tovc -the 

address ih vav-iablc j>. w 


..and free up the memory with free!) 

Once you’ve created the memory on the heap, you can use 
it for as long as you like. But once you’ve finished, you need 
to release the memory using the free () function. 

free () needs to be given the address of the memory that 
malloc () created. As long as the library is told where the 
chunk of memory starts, it will be able to check its records 
to see how much memory to free up. So if you wanted to 
free the memory you allocated above, you’d do it like this: 

free (p) ； ^^This means, u Rclcasc -the memory you 

allodaied -fv-om heap addv-css f. w 


OK, now that we know more about dynamic 
memory, we can start to write some code. 


Rememlier* il you 
allocatect memory 
witk mallocO in one 


part oi your prog[ram, 
you skoulct always 
release it later witk 
tke IreeO iunction. 
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Oh, wo! If s the out - of - work actors 


The aspiring actors are currently between jobs, so 
they’ve found some free time in their busy schedules 
to help you out with the coding. They’ve created a 
utility function to create a new island struct 
with a name that you pass to it. The function looks 
like this: 


TWis is ^ M 七 10 … 


This will Cxtdi^t a | 

islolhd stv-u^t s _ 、 

oy\ the heap. ^ 

island *i 

These Irncs sc*t 七 he 

-f ields OY\ 七 he Y\t^l S*tvud*t -( 

’i->name — 
/i->opens 

i->closes 

( 

i->next = 


return i; 

} 

The -Puhd't 


The of -the island is 
passed as a dhav Pomtcv. 

island* create (char *name) Its us'm^ *tV>C mallodO -fur>d*tioy> 

- {p dvca*tc spade oy \ 七 he iicap. 



malloc(sizeof(island)) 


name; 

: "09:00" 
="17 : 00 
NULL; 


address o( the hew 

That’s a pretty cool-looking function. The actors 
have spotted that most of the island airports have 
the same opening and closing times, so they’ve set 
the opens and closes fields to default values. 

The function returns a pointer to the newly created 
struct. 


The siicc4 - opc\ra-to\r wovks oui how 
你 如 y byics av-c needed- 






Look carefully at the code for the create () function. Do you think there 
might be any problems with it? Once you’ve thought about it good and 
hard, turn the page to see it in action. 
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the game is afoot 


The Case of the Vanishing Island 

Captain’s Log. 11:00. Friday. Weather clear. A create () function 
using dynamic allocation has been written, and the coding team says it 
is ready for air trials. 



Flve^lnute 

JVtystery 


island* create (char *name) 

{ 

island *i = malloc(sizeof(island)); 

i->name = name; 

i->opens = "09:00"; 

i->closes = "17:00"; 

i->next = NULL; 

return i; 


14:15. Weather cloudy. Northwest headwind 15kts near Bermuda. 
Landing at first stop. Software team on board providing basic code. 
Name of island entered at the command line. 


ah awy io stov-c island 
Ask 如 ⑽ k 如一 c ,sUd . 


'''■^char name [ 80]; 

. — ^vfgets(name, 80, stdin); 

island *p islandO = create(name); 



14:45. Take off from landing strip rocky due to earth tremors. Software 
team still on board. Supplies of Jolt running low. 
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15:35. Arrival at second island. Weather good. No wind. Entering 
details into new program. 


Ask the usev- -to the 
the sc^ohd island- 


TW»s dovmc 出七 
-bo -bV^c sttov\d »sbv\d- 


fgets(name, 80, stdin); 

island *p—islandl = create(name) 

p_islandO->next = p_islandl; 


寸 TWis tv-ca-tcs i\\c 

sc£>oy\d island- 


I Filp FHit WinHnw Hpln I 


Titchmarsh Island 


17:50 Back at headquarters tidying up on paperwork. Strange thing. 
The flight log produced by the test program appears to have a bug. 
When the details of today’s flight are logged, the trip to the first island 
has been mysteriously renamed. Asking software team to investigate. 


display the details 
si o*P isl 


This will 

of the list ol' islands usih3 -the 
tuhdtioh wc Ort^itA eav'lie^. 


display(p islandO) 


Filp FHit WinHnw Hpln 




Name : Titchmarsh Island 
open : 09 : 00-17 : 00 
Name : Titchmarsh Island 
open : 09 : 00-17 : 00 


一 ” hUd how 
^ the as 

^ s ^ohd islahdW 

• • • 


What happened to the name of the first island? Is there 
a bug in the create () function? Does the voay it voas 
called give any clues? 


you are here ► 
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The Case of the Vanishing Island 

What happened to the name of the first island? 

Look at the code of the create () function again: 

island* create(char *name) 

{ 

island *i = malloc(sizeof(island)); 
i->name = name; 
i->opens = "09:00"; 
i->closes = "17:00"; 
i->next = NULL; 
return i; 



When the code records the name of the island, it doesn’t take a copy of 
the whole name string; it just records the address where the name string 
lives in memory. Is that important? Where did the name string live? We 
can find out by looking at the code that was calling the function: 

char name[80]; 
fgets(name, 80, stdin); 
island *p_island0 = create(name); 
fgets(name, 80, stdin); 
island *p islandl = create(name); 


The program asks the user for the name of each island, but both times 
it uses the name local char array to store the name. That means that 

the two islands share the same name string. As soon as the local 
name variable gets updated with the name of the second island, the 
name of the first island changes as well. 
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- String Copying Up Cl^se 

In G, you often need to make copies of strings. You could do that by calling the 
malloc () function to create a little space on the heap and then manually copying 
each character from the string you are copying to the space on the heap. But guess 
what? Other developers got there ahead of you. They created a function in the 
string.h header called strdup (). 



Let’s say that you have a pointer to a character array that you want to copy: 


char *s = "MONA LISA n ; 




The strdup () function can reproduce a complete copy of the string somewhere 
on the heap: 

char *copy = strdup(s); 



The strdupO function works out how long the string is, and then 
calls the malloc() function to allocate the correct number of 
characters on the heap. 




Thafs 10 characters from 
position s to the \0 character, 
and malloc(lO) tells me I’ve got 
space starting on the heap at 
location 2,500,000. 


It then copies each of the characters to the new space on the heap. 



That means that strdup () always creates space on the heap. It can’t create space on 
the stack because that’s for local variables, and local variables get cleared away too often. 

But because strdup () puts new strings on the heap, that means you must always 
remember to release their storage with the free () function. 


you are here ► 
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use strdupQ 


Uf s fix the code using the strdupO fuwctiow 

You can fix up the original create () function using the 
strdup () function, like this: 

island* create (char *name) 


island *i = malloc(sizeof(island)); 
i->name = strdup(name); 


i->opens = "09:00"; 
i->closes = "17:00"; 
i->next = NULL; 
return i; 


You can see that we only need to put the strdup () function on 
the name field. Gan you figure out why that is? 

It’s because we are setting the opens and closes fields to string 
literals. Remember way back when you saw where things were 
stored in memory? String literals are stored in a read-only area 
of memory set aside for constant values. Because you always 
set the opens and closes fields to constant values, you don’t 
need to take a defensive copy of them, because they’ll never 
change. But you had to take a defensive copy of the name array, 
because something might come and update it later. 

So does it fix the code? 

To see if the change to the create () function fixed the code, 
let’s run your original code again: 


D 


th&re^cur 

)umb 


e no o 

Questions 


If the island struct had a 
name array rather than a character pointer, 
would I need to use strdup () here? 

No. Each island struct would 
store its own copy, so you wouldn’t need to 
make your own copy. 

So why would I want to use char 
pointers rather than char arrays in my 
data structures? 

char pointers won’t limit the amount of 
space you need to set aside for strings. If you 
use char arrays, you will need to decide in 
advance exactly how long your strings might 
need to be. 


I File Edit Window Help CoconutAirways 


> ./test 一 flight 
Atlantis 

Titchmarsh Island 
Name : Atlantis 
open : 09:00-17 : 00 
Name: Titchmarsh Island 
open : 09:00-17 : 00 


Now that code works. Each time the user enters the name of an island, 
the create () function is storing it in a brand-new string. 

OK, now that you have a function to create island 
data, let’s use it to create a linked list from a file. 
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Paa] puzz]c 

Catastrophe! The code to create an island tour has 
fallen into the pool! Your job is to take code 
snippets from the pool and place them into the 
blank lines in the code below. Your goal is to 
reconstruct the program so that it can read a list 
of names from Standard Input and then connect 
them together to form a linked list. You may not 
use the same code snippet more than once, and 
you won’t need to use all the pieces of code. 

island *start = NULL; 
island *i = NULL; 
island *next = NULL; 
char name[80]; 

for (; != ; i = 

next = create(name); 
if (start — NULL) 

start — ; 

if (i != NULL) 

i — next; 


display(start); 



Note: each thing from 
the pool can be used 
only once! 
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out of the pool 



Paa] puzzjc 

Catastrophe! The code to create an island tour has 
fallen into the pool! Your job was to take code 
snippets from the pool and place them into the 
blank lines in the code below. Your goal was to 
reconstruct the program so that it can read a list 
of names from Standard Input and then connect 
them together to form a linked list. 


island *start = NULL; 

island *i = NULL; M 七 he ⑶ d d ea 乩 

island *next = NULL; r , r , j I Dl 4- loop ， 兄七 i -to ihc 灼 

Read a *tKc hput. island wc 七 ed. 

char name[80]; ^ 

for (; fgets(name, 80, stdin) != NULL ; i = next ) { 

This Creates ^next = create (name) ; . i • Ac 

Hd. ,—— 爾丁、 Well keep loo P m5 ur.t.1 ^ do^ s^m^s. 

in (start — im u J_i -L ) _. ii. I 

_ _, he -rirst time through, start is set h> 

start = .…… n e . xt "..^T..'• NULL, so set \i io Ihc (\rsi island. 

if (i != NULL) 

i . ->.next . = next; 

display ( start ) ; 七 *fo\rgct i is ol ponrtev, so 

well use -> ho-btioh. 


Note: each thing from 
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^Sharpen your pencil 


But wait! You’re not done yet. Don’t forget that if you ever 
allocate space with the malloc () function, you need to 
release the space with the free () function. The program 
you’ve written so far creates a linked list of islands in heap 
memory using malloc (), but now it's time to write some code 
to release that space once you’re done with it. 

Here’s a start on a function called release () that will release 
all of the memory used by a linked list, if you pass it a pointer to 
the first island: 


void release(island *start) 

{ 

island *i = start; 
island *next = NULL; 
for (; i != NULL; i = next) { 
next = ; 


Think very carefully. When you release the memory, what will you need to free? Just the island, or 
something more? In what sequence should you free them? 
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^Jharpen your pencil_ 

Solution But wait! You’re not done yet. Don’t forget that if you ever 

allocate space with the malloc () function, you need to 
release the space with the free () function. The program 
you’ve written so far creates a linked list of islands in heap 
memory using malloc () , but now it's time to write some code 
to release that space once you’re done with it. 

Here’s a start on a function called release () that will release 
all of the memory used by a linked list, if you pass it a pointer to 
the first island: 

void release(island *start) 

{ 

island *i = start; 

island *next = NULL; 

for (; i != NULL; i = next) { 

e ^ next = i->hcx.*t ~ Sc*t b> b> island. 

rWst, you heed -to Wtt - - r .. .. 

the sVmg 

trcaicd v/iih sivdupO. {wO. . ; 0hly a-Ptc\r the 

} should you -the island s-tv-udt 

} youd -Pv-ccd i\\t island -first you v\oi 

have \)ttv\ able bo vtacM 七 he y»amc -to (ret it 

When you release the memory, what will you need to free? Just the island, or something more? In 
what sequence should you free them? 


Free the memory when youYe done 

Now that you have a function to free the linked list, you’ll 
need to call it when you’ve finished with it. Your program 
only needs to display the contents of the list, so once you’ve 
done that, you can release it: 

display(start); 
release (start); 

Once that’s done, you can test the code. 
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Tqst DriVq 


So, if you compile the code and then run the file through it, what 
happens? 


I File Edit Window Help FreeSpaceYouDon'tNeed 


> ./tour < tripl.txt 
Name : Delfino Isle 
Open : 09 : 00-17 : 00 
Name : Angel Island 
Open : 09:00 - 17:00 
Name : Wild Cat Island 
Open : 09 : 00-17 : 00 
Name : Neri's Island 
Open : 09 : 00-17 : 00 
Name : Great Todday 
Open : 09:00-17:00 
Name : Ramita de la Baya 
Open : 09:00 - 17:00 
Name : Island of the Blue Dolphins 
Open : 09 : 00-17 : 00 
Name : Fantasy Island 
Open : 09:00 - 17:00 
Name : Fame 
Open : 09 : 00-17 : 00 
Name : Isla de Muert 
Open : 09 : 00-17 : 00 
Name : Tabor Island 
Open : 09:00-17:00 
Name : Haunted Isle 
Open : 09 : 00-17 : 00 
Name : Sheena Island 
Open : 09:00-17:00 


It works. Remember: you had no way of knowing how long that 
file was going to be. In this case, because you are just printing out 
the file, you could have simply printed it out without storing it all 
in memory. But because you do have it in memory, you’re free to 
manipulate it. You could add in extra steps in the tour, or remove 
them. You could reorder or extend the tour. 


Dynamic memory allocation lets you create the 
memory you need at RUNTIME. And the way you 
access dynamic heap memory is with malloc () and 
free (). 
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Tonight’s Talk： Stack and Heap Discuss Their Differences 


Stack: Heap: 

Heap? Are you there? I’m home. 

Don’t see you too often this time of day. Got a little 
something going on? 

Deep regression. Oops.. .excuse me... Just tidy that 
up … 

What’re you doing? 

The code just exited a function. Just need to free up 
the storage from those local variables. 

You should take life a little easier. Relax a little … 

Perhaps you’re right. Mind if I sit? 

Beer? Don’t worry about the cap; throw it anywhere. 

I.. .think this is yours? 

Hey, you found the pizza! That’s great. I’ve been 
looking for that all week. 

You really should consider getting somebody in to 
take care of this place. 

Don’t worry about it. That online ordering 
application left it lying around. It’ll probably be 
back for it. 

How do you know? I mean, how do you know it 
hasn’t just forgotten about it? 

He’d have been back in touch. He’d have called 
free (). 

Hmmm? Are you sure? Wasn’t it written by the 
same woman who wrote that dreadful Whack-a- 
bunny game? Memory leaks everywhere. I could 
barely move for rabbit structs. Droppings 
everywhere. It was terrible. 
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Stack: Heap: 

Hey, it’s not my responsibility to clear up the 
memory. Someone asks me for space, I give him 
space. I’ll leave it there until he tells me to clean 
it up. 

That’s irresponsible. 

Yeah, maybe. But I’m easy to use. Not like you and 
your.. .fussing. 

Fussing? I don’t fuss! You might want to use a 
napkin... 

〈 belches> What? I’m just saying you’re difficult to 
keep track of. 

I just believe that memory should be properly 
maintained. 


You’re messy. 

Why don’t you do garbage collection?! 

I mean, just a little.. .tidying up. You don’t do 
anything!!! 


Whatever. I’m a live-and-let-live type. If a program 
wants to make a mess, it’s not my responsibility. 

I’m easygoing. 

Ah, here we go again … 


Easy, now. 


<crying>I’m sorry. I just can’t cope with this level of 
disorganization. 


Hey, you’re overflowing. Take this... 


<blows nose>Thank you. Wait, what is this? 


It’s the high score table from Whack-a-Bunny. 
Don’t worry; I don’t think the program needs it 
anymore. 
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Why is the heap called the heap? 

Because the computer doesn’t 
automatically organize it. It’s just a big heap 
of data. 

What’s garbage collection? 

Some languages track when you 
allocate data on a heap and then, when 
you’re no longer using the data, they free 
the data from the heap. 

Why doesn’t C contain garbage 
collection? 

C is quite an old language; when it 
was invented, most languages didn’t do 
automatic garbage collection. 



I understand why I needed to 
copy the name of the island in the 
example. Why didn’t I need to copy the 
opens and closes values? 

The opens and closes values 
are set to string literals. String literals can’t 
be updated, so it doesn’t matter if several 
data items refer to the same string. 

Does strdup () actually call 
the malloc () function? 

It will depend on how the C Standard 
Library is implemented, but most of the 
time, yes. 


Do I need to free all my data 
before the program ends? 

You don’t have to; the operating 
system will clear away all of the memory 
when the program exits. But it’s good 
practice to always explicitly free anything 
you’ve created. 


BULLET POINTS 一 

■ Dynamic data structures allow you 
to store a variable number of data 
items. 

■ A linked list is a data structure that 
allows you to easily insert items. 

■ Dynamic data structures are 
normally defined in C with recursive 

structS. 

■ A recursive struct contains 
one or more pointers to a similar 

struct. 


The stack is used for local variables 
and is managed by the computer. 

The heap is used for long-term 
storage. You allocate space with 

malloc(). 

The sizeof operator will tell you 
how much space a struct needs. 

Data will stay on the heap until you 
release it with free (). 
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data structures and dynamic memory 




You’ve seen how to create a linked list in G. But linked lists aren’t the 
only data structures you might need to build. Below are some other 
example data structures. See if you can match up the data structure 
with the description of how it can be used. 


Pata structure 


Pescriptiow 





I can be used to store a sequence of items 
and I make it easy to insert new items. But 
you can process me in only one direction. 


Each item I store can connect to up to 
two other items. I am useful for storing 
hierarchical information. 


I can be used to associate two different 
types of data. For example, you could use 
to me to associate people’s names to their 
phone numbers. 


Each item I store connects to up to two 
other items. You can process me in two 
directions. 
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that’s my data structure 









You’ve seen how to create a linked list in G. But linked lists aren’t the 
only data structures you might need to build. Below are some other 
example data structures. You were to match up the data structure with 
the description of how it can be used. 


Associated array or map 

I 七 do^^cd-U key 

V J *to 

value m-fo\rma*t>or\. 


Pescriptiow 





Poubly linked list 


■> 


<■ 


<■ 


，•个 

s like 3 linked bu 七 rt 

has tov\r\tthov\s both way ： 

Linked list 



binary tree 



I can be used to store a sequence of items, 
and I make it easy to insert new items. But 
you can process me in only one direction. 


Each item I store can connect to up to 
two other items. I am useful for storing 
hierarchical information. 


I can be used to associate two different 
types of data. For example, you could use 
to me to associate people’s names to their 
phone numbers. 


Each item I store connects to up to two 
other items. You can process me in two 
directions. 
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Pata structures arc useful but be careful! 

You need to be careful when you create these data structures 
using G. If you don’t keep proper track of the data you are 
storing, there’s a risk that you’ll leave old dead data on the heap. 
Over time, this will start to eat away at the memory on your 
machine, and it might cause your program to crash with memory 
errors. That means it’s really important that you learn 
to track down and fix memory leaks in your code... 
































data sf/x/cfc/res and dynamic memory 


TOP SECRET 


Federal Bureau of Investigations United States Department of 
Justice, Washington, D. C. 

From: J. Edgar Hoover, Director 

Subject: SUSPECTED LEAK IN GOVERNMENT EXPERT SYSTEM 
Our Cambridge, MA, office advised ⑽ 

somewhere inside the new Suspicious Persons Identificatio 
Expert System (SPIES). Our sources and informants fami 

with software matters advise that the 3 卿 ：=:_ 
result of shoddy coding by person or persons unknown. 

An informant who has furnished reliable information in the v^st 
tSdwho claims to be close to the people conceme f=== he 
that the leak is the result of careless , ^ 峨 1 , 
area of memory known to the hacker fraternity as The Heap. 

You are hereby given access to the 卿 ^==^==2 of 
theSssoft^eS^^ 

analyze the details of the case carefully. I want this leak fou , 
and I want this leak fixed. 

Failure is not an option. 


Very truly yours, 
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Exhibit A: the source code 

What follows is the source code for the Suspicious Persons 
Identification Expert System (SPIES). This software can be 
used to record and identify persons of interest. You are not 
required to read this code in detail now，but please keep a copy 
in your records so that you may refer to it during the ongoing 
investigation. 


^include <stdio.h> 

^include <stdlib.h> 

^include <string.h> 

typedef struct node 
char ^question; 
struct node *no; 
struct node 
} node; 

int yes_no(char *question) 
char answer[3]; 

printf("%s? (y/n) : ", question) 

fgets(answer, 3, stdin); 
return answer[0] 


node* create(char *question) 



node *n = malloc(sizeof(node)) 
n->question = strdup(question) 
n->no = NULL; 
n->yes — NULL; 
return n; 


void release(node *n) 


if (n) { 

if (n->no) 

release (n->no); 
if (n->yes) 

release(n->yes); 
if (n->question) 

free(n->question); 
free(n); 
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—--- 

int main() 

{ 

char question [80]; 
char suspect [20]; 

node *start—node = create("Does suspect have a mustache") 
start_node->no = create ( "Loretta Barnsworth"); 
start_node->yes = create ("Vinny the Spoon ，'）； 

node *current; 
do { 

current = start—node; 
while (1) { 

if (yes—no(current->question)) 

{ 一 

if (current->yes) { 

current = current->yes; 

} else { 

printf ("SUSPECT 工 DENTIFIED\n ，'）； 
break; 


else if 
current 
else { 


(current->no) 

current->no; 


/* Make the yes-node the new suspect name */ 
printf ( "Who ' s the suspect? ’，）； 
fgets(suspect, 20, stdin); 
node *yes_node = create(suspect); 
current->yes = yes—node; 

/* Make the no-node a copy of this question * 
node *no node = create(current->question); 


current->no 


no node 


/* Then replace this question with the new question */ 
printf("Give me a question that is TRUE for %s but not for %s? 

current->question); 
fgets(question, 80, stdin); 
current->question = strdup(question); 


break, 


suspect. 


} while (yes_no ("Run again ’，））； 
release(start—node); 
return 0; 
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Aw overview of the SPIES system 

The SPIES program is an expert system that learns how to identify 
individuals using distinguishing features. The more people you enter 
into the system, the more the software learns and the smarter it gets. 


The program builds a tree of suspects 

The program records data using a binary tree. A binary tree allows 
each piece of data to connect to two other pieces of data like this: 



5 


This is what the data looks like when the program starts. The first 
item (or node) in the tree stores a question: “Does the suspect have a 
mustache?” That’s linked to two other nodes: one if the answer’s 從， 
and another if the answer’s no. The yes and no nodes store the name 
of a suspect. 


The program will use this tree to ask the user a series of questions 
to identify a suspect. If the program can’t find the suspect, it will ask 
the user for the name of the new suspect and some detail that can be 
used to identify him or her. It will store this information in the tree, 
which will gradually grow as it learns more things. 



Let’s see what the program looks like in action. 


Tk Xcs alv/ays a ?? ca^r at 

七 ends of *brcc. 
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This is what happens if an agent compiles the SPIES program and 
then takes it on a test run: 


File Edit Window Help TrustNoone 


> gcc spies.c -o spies && ./spies 
Does suspect have a mustache? (y/n) : n 
Loretta Barnsworth? (y/n) : n 

Who's the suspect? Hayden Fantucci 

Give me a question that is TRUE for Hayden Fantucci 
but not for Loretta Barnsworth? Has a facial scar 
Run again? (y/n) : y 

Does suspect have a mustache? (y/n) : n 

Has a facial scar 

? (y/n) : y 

Hayden Fantucci 

? (y/n) : y 

SUSPECT IDENTIFIED 

Run again? (y/n) : n 

> * 


The first time through, the program fails to identify the suspect 
Hayden Fantucci. But once the suspect’s details are entered, the 
program learns enough to identify Mr. Fantucci on the second run. 

Pretty swart. So whaf s the problem? 

Someone was using the system for a few hours in the lab and noticed 
that even though the program appeared to be working correctly, it 
was using almost twice the amount of memory it needed. 

That’s why you have been called in. Somewhere deep in the source 
code, something is allocating memory on the heap and never freeing 
it. Now ，you could just sit and read through all of the code and hope 
that you see what’s causing the problem. But memory leaks can be 
awfully difficult to track down. 


So maybe you should pay a trip to the software lab... 
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valgrind 


Software forewsics: using valgrind 


It can take an achingly long time to track down bugs in large, 
complex programs like SPIES. So G hackers have written tools that 
can help you on your way. One tool used on the Linux operating 
system is called valgrind. 

valgrind can monitor the pieces of data that are allocated 
space on the heap. It works by creating its own fake version 
of malloc (). When your program wants to allocate some 
heap memory, valgrind will intercept your calls to malloc () 
and free () and run its own versions of those functions. The 
valgrind version of malloc () will take note of which piece of 
code is calling it and which piece of memory it allocated. When your 
program ends, valgrind will report back on any data that was left 
on the heap and tell you where in your code the data was created. 

Prepare your code: add debug info 

You don’t need to do anything to your code before you run it through 
valgrind. You don’t even need to recompile it. But to really get 
the most out of valgrind, you need to make sure your executable 
contains debug information. Debug information is extra data that 
gets packed into your executable when it’s compiled — things like the 
line number in the source file that a particular piece of code was 
compiled from. If the debug info is present, valgrind will be able 
to give you a lot more details about the source of your memory leak. 


To add debug info into your executable, you need to recompile the 
source with the -g switch: 

Just the facts: interrogate your code 



mallocO 

valy'md 
dalls *to 

mdllodO 

dy>d -f^rccO 
-fur>d*tioy>s. 


T 

valg\rmd will keep brack o( daia 
七 hat is but hot -f\rccd- 


gcc -g spies.c -o spies 

TKc -5 SY/rtdh tells tomfilcv 

*to vedovd I me 

aga.ms 七 toAt *rt tomfilcs. 


To see how valgrind works, let’s fire it up on a Linux box and use ~Y® u ou 七 if val^v'md is avaibb c 

it to interrogate the SPIES program a couple times. 0 的 y ouV " sys-tc^ how *to 

ms*tall i*t at http/ / valymd ov-j. 

The first time, use the program to identify one of the built-in 
suspects: Vinny the Spoon. You’ll start valgrind on the command 
line with the --leak-check=f ull option and then pass it the 
program you want to run: 


File Edit Window Help valgrindRules 


> valgrind --leak-check=full ./spies 

==1754== Copyright (C) 2002-2010, and GNU GPL'd, by Julian Seward et al• 

Does suspect have a mustache? (y/n) : y 

Vinny the Spoon? (y/n) : y 

SUSPECT IDENTIFIED 

Run again? (y/n) : n 

==1754== All heap blocks were freed 一一 no leaks are possible 
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Use valgrmd repeatedly to gather more evidence 

When the SPIES program exited, there was nothing left on 
the heap. But what if you run it a second time and teach the 
program about a new suspect called Hayden Fantucci? 


File Edit Window Help valgrindRules 


> valgrind --leak-check=full ./spies 

==2750== Copyright (C) 2002-2010, and GNU GPL'd, by Julian Seward et al. 
Does suspect have a mustache? (y/n) : n 
Loretta Barnsworth? (y/n) : n 
Who's the suspect? Hayden Fantucci 

Give me a question that is TRUE for Hayden Fantucci ..... , 

but not for Loretta Barnsworth? Has a facial scar abated pieces 

Run again? (y/n) : n ^ \°( bytes was oy\ i\\t Kcaf. ^c^o\ry II but 

==2750== HEAP SUMMARY: Y- ohly -fv-ccd lO o( them. 

==2750== in use at exit: 19 bytes in 1 blocks 

==2750== total heap usage: 11 allocs, 10 frees, 154 bytes allocated 
==2750== 19 bytes in 1 blocks are definitely lost in loss record 1 of 1 
==2750== at 0x4026864 : malloc (vg_replace_malloc.c:236) 

==2750== by 0x40B3A9F: strdup (strdup. c : 45) 

==2750== by 0x8048587: create (spies • c: 22) Imes (\We us dy>V dlucs? 

==2750== by 0x804863D : main (spies . c: 46) 

==2750== LEAK SUMMARY: ▽ 

==2750== definitely lost: 19 bytes in 1 blocks 


(vg_replace_malloc.c : 236) 

(strdup. c : 43) ^ 

(spies . c^22) p 0 七|^仪 Imcs us a 的 y 


dlucs? 




Why ^ by-tes? |s ihai a due? 


This time, valgrind found a memory leak 

It looks like there were 19 bytes of information left on the 
heap at the end of the program, valgrind is telling you 
the following things: 

19 bytes of memory were allocated but not freed. 

Looks like we allocated new pieces of memory 11 times, but freed only 10 of them. 
Do these lines give us any clues? 

Why 19 bytes? Is that a clue? 

That’s quite a few pieces of information. Let’s take these 
facts and analyze them. 


o 

o 

o 

o 
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valgrind 


Look at the evidence 

OK, now that you’ve run valgrind, you’ve collected quite a few 
pieces of evidence. It’s time to analyze that evidence and see if you 
can draw any conclusions. 

1. Location 

You ran the code two times. The first time, there was no problem. 
The memory leak only happened when you entered a new suspect 
name. Why is that significant? Because that means the leak can’t 
be in the code that ran the first time. Looking back at the source 
code, that means the problem lies in this section of the code: 



} else if (current->no) { 


current = current->no; 
} else { 


/* Make the yes-node the new suspect name */ 
printf ("Who ' s the suspect? ’▼); 
fgets(suspect, 20, stdin); 
node *yes node = create (suspect); 
current->；es ^ y es_node; 

/* Make the no-node a copy of this question */ 
node *no—node = create(current->question); 
current->no = no node; 

printf("Give me a question that is TRUE for %s but 
suspect, current->question); 
fgets(question, 80, stdin); 
current->question = strdup(question); 


break; 
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Z. Clues from valgriwd 

When you ran the code through valgrind and added a single 
suspect, the program allocated memory 11 times, but only released 
memory 10 times. What does that tell you? 

valgrind told you that there were 19 bytes of data left on the 
heap when the program ended. If you look at the source code, 
what piece of data is likely to take up 19 bytes of space? 

Finally, what does this output from valgrind tell you? 



50== 

19 bytes in 1 blocks are 

definitely lost in loss record 1 of 1 


50== 

at 

0x4026864: 

malloc 

(vg replace malloc.c : 236) 


50== 

by 

0x40B3A9F: 

strdup 

(strdup. c : 43) 


50== 

by 

0x8048587: 

create 

(spies.c:22) 


50== 

by 

0x804863D: 

main (spies.c:46) 






Consider the evidence carefully, then answer these questions. 


1. How many pieces of data were left on the heap? 


2. What was the piece of data left on the heap? 


3. Which line or lines of code caused the leak? 


4. How do you plug the leak? 
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VSA 


VSA - 钟 - 钟 - 飾 


cunning plan 


- + 

You were to consider the evidence carefully and answer these questions. 

1. How many pieces of data were left on the heap? 

There is ov\t piede da*ba.. . 

2. What was the piece of data left on the heap? 

The . w Lp\rc*tta. li!?!®. 々 h 孕七 h . 孕 . 

3. Which line or lines of code caused the leak? 

The drcatcO fuhd-tiohs -themsdyes do^*t dause jeaks Ipcdausc they didh^-t or\ -the -firs-t pass, 
so i*t rwust be *this stvdupf) J.mc ； 

.... ^ s*brdup(^ucs^ior \)； . 

4. How do you plug the leak? 

[-f ^ly-cady pom-tmg Jjo. . 奶 . • 七 .h ㈡ P 人 :(V • 弘 . bc-forc 

. .sllodatmg a . r\Cyy .^ucs-tioh ； . 

. . ^C.c(^V!TX^iri. . 

.. ^V'.vrc.^tr.^ucstipn rrr. .^dup.C^uCsiioh )； . 
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The fix ow trial 

Now that you’ve added the fix to the code, it’s time to run the 
code through valgrind again. 


File Edit Window Help valgrindRules 


> valgrind --leak-check=full ./spies 

==1800== Copyright (C) 2002-2010, and GNU GPL'd, by Julian Seward et al• 
Does suspect have a mustache? (y/n) : n 
Loretta Barnsworth? (y/n) : n 
Who's the suspect? Hayden Fantucci 

Give me a question that is TRUE for Hayden Fantucci 
but not for Loretta Barnsworth? Has a facial scar 
Run again? (y/n) : n 

==1800== All heap blocks were freed -一 no leaks are possible 

> 


The leak is fixed 

You ran exactly the same test data through the program, and 
this time the program cleared everything away from the heap. 

How did you do? Did you crack the case? Don’t worry if you 
didn’t manage to find and fix the leak this time. Memory 
leaks are some of the hardest bugs to find in G programs. 

The truth is that many of the G programs available probably 
have some memory bugs buried deep inside them, but that’s 
why tools like valgrind are important. 


o 

o 

o 


Spot when leaks happen. 

Identify the location where they happen. 
Check to make sure the leak is fixed. 
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no dumb questions 


tJieretcire no o 

Dumb Questions 


valgrind said the leaked 
memory was created on line 46, but the 
leak was fixed on a completely different 
line. How come? 

The “Loretta...” data was put 
onto the heap on line 46, but the leak 
happened when the variable pointing to 
it (current->question) was 
reassigned without freeing it. Leaks don’t 
happen when data is created; they happen 
when the program loses all references to 
the data. 

Can I get valgrind on my Mac/ 
Windows/FreeBSD system? 

Check http://valgrind.org for details 
on the latest release. 


How does valgrind intercept 
calls to malloc () and free () ? 

The malloc () and free () 

functions are contained in the C Standard 
Library. But valgrind contains a library 
with its own versions of malloc () and 
free (). When you run a program with 
valgrind, your program will be using 
valgrind's functions, rather than the 
ones in the C Standard Library. 

Why doesn’t the compiler always 
include debug information when it 
compiles code? 

Because debug information will make 
your executable larger, and it may also 
make your program slightly slower. 


Where did the name valgrind 
come from? 

Valgrind is the name of the entrance 
to Valhalla, valgrind (the program) 
gives you access to the computer’s heap. 


BULLET POINTS —— 

■ valgrind checks for memory 
leaks. 

■ valgrind works by intercepting 
the calls to malloc () and 
free (). 

■ When a program stops running, 
valgrind prints details of what’s 
left on the heap. 

■ If you compile your code with debug 
information, valgrind can give 
you more information. 


■ If you run your program several times, 
you can narrow the search for the 
leak. 

■ valgrind can tell you which lines 
of code in your source put the data 
on the heap. 

■ valgrind can be used to check 
that you’ve fixed a leak. 
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Your C Toolbox 

You’ve got Chapter 6 under 
your belt，and now you’ve 
added data structures and 
dynamic memory to your toolbox. 
For a complete list of tooltips in the 
book, see Appendix ii. 



\\si 


Data cav\ 

be ihsc\rtcd 
easily ih*to 3 
lihked list 


daia 


Dyhamid d 

st\rud*tuvcs 
use recursive 
strud*ts. 



RctursWc 

stru^ts 60 山 … 

oY\t or more 
Imks -bo similar 


rindllodO 
alloda 七 es 
memory oy\ 
heap. 


s*brdufO y/ill 

ertait a dopy 

of d oh 

{ht heap. 


^rCC() 

你 t 你 0 叫 OYK 

V^cav* 


A mCworY 
*,s allocated 
mcmor'/ 70 U 
no Wf access. 


Uhlike -the 
s*tadk, heap 

nr\Cnr»OV-y is hot 

au-tomatidally 

released. 


valg\rihd tav\ 
help you 
"bradk dov/h 
mcnr»o\ry leaks. | 


The si^dc 
' s used 
^ lodsl 
v ^blcs. 
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7 adVcinced functions 





My go—on—date() 
is awesome now 
that IVe discovered 
variadic functions. 


參 Turn your functions 


up to 11 


Basic functions are great, but sometimes you need more. 

So far, you’ve focused on the basics, but what if you need even more power and 
flexibility to achieve what you want? In this chapter, you’ll see how to up your code’s 
IQ by passing functions as parameters. You’ll find out how to get things sorted with 
comparator functions. And finally, you’ll discover how to make your code super stretchy 
with variadic functions. 
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true love 


Looking for Mr. Right... 

You’ve used a lot of G functions in the book so far, but the 
truth is that there are still some ways to make your G functions 
a lot more powerful. If you know how to use them correctly, G 
functions can make your code do more things but without 
writing a lot more code. 

To see how this works, let’s look at an example. Imagine 
you have an array of strings that you want to filter down, 
displaying some strings and not displaying others: 


int NUM—ADS = 7; 
char *ADS[] = { 


'William : SBM GSOH likes sports, TV, dining ", 
'Matt : SWM NS likes art, movies, theater ", 
’Luis: SLM ND likes books, theater, art ", 

'Mike : DWM DS likes trucks , sports and bieber 
'Peter : SAM likes chess, working out and art" 


Josh : SJM likes sports, movies and theater", 
Jed : DBM likes theater, books and dining" 
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Let’s write some code that uses string 
functions to filter this array down. 


advanced functions 


C 0c ^ e Magnets 



Complete the find () function so it can track down all the sports fans in 
the list who don't also share a passion for Bieber. 


Beware: you might not need all the fragments to complete the function. 



void find() 

{ 

int in¬ 
puts ("Search results:"); 

puts (’▼ - ’▼); 

for (i = 0; i ; i++) { 

if ( ( , ) 



printf ( n %s\n n , ADS[i]); 


puts (’▼ 




[^J 



0 


「 strcmp j 



I '^sports" I 
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magnets solved 


Code Magnets Solution 



You were to complete the find () function so it can track down all the 
sports fans in the list who don’t also share a passion for Bieber. 



void find() 

{ 

int i ; 

puts ("Search results:’ 1 ) 
puts (’▼ - 


for (i = 0; 


if 


< 



； i++) 









)) 


printf( n %s\n n , ADS[i]); 


puts (" 


strcmp 



strcmp 
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Tqst DriVq 


Now, if you take the function and the data, and wrap everything 
up in a program called find. c, you can compile and run it like 
this: 


| File Edit Window Help FindersKeepers 




> gcc find.c 一 o find && 
Search results : 

./find 



William: SBM GSOH likes 

sports, 

TV, 

dining 

Josh: SJM likes sports. 

movies 

and 

theater 

> 





And sure enough, the find () function loops through the array 
and finds the matching strings. Now that you have the basic code, 
it would be easy to create clones of the function that could perform 
different kinds of searches. 


Hey, wait! Clone? Clone the 
function???? That*s dumb. Each version 
would only vary by, like, one line. 


Exactly right. If you clone the function, you’ll 
have a lot of duplicated code. 

G programs often have to perform tasks that are almost identical 
except for some small detail. At the moment, the find () 
function runs through each element of the array and applies a 
simple test to each string to look for matches. But the test it makes 
is hardwired. It will always perform the same test. 

Now, you could pass some strings into the function so that it could 
search for different substrings. The trouble is, that wouldn’t allow 
find () to check for three strings, like “arts，” “theater，’’ or “dining. 
And what if you needed something wildly different? 

You need something a little more sophisticated.. 


fvncV sow 
uoV^o \瓣 




or 


0。七 




I ⑴ 3rvt 3 non- 
SnnoKer uoho 
liKes -the 
■thea-ter. 

fvnd someone 
uoho \\^es 七 he 
ar-t ； -th03-t0r ； or 
d-vnvno^. 
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give the function code 


Pass code to a function 


What you need is some way of passing the code for the 


test to the find () function. If you had some way of 
wrapping up a piece of code and handing that code to the 
function, it would be like passing the find () function a 
testing machine that it could apply to each piece of data. 



TW.s matWrnc looks U ?co ? lc 

like a 士 ， OV 




Rod someone 
u)ho liKes 
sports or 
u)orK\no^ ou 七 . 




丁卜 ,^ CS ^ ，h 9 looks -fo^ 

Wh ° ，，kc S P ° 士 o^r wo^kih 9 oui 


people ^ 




This means the bulk of the find () function would stay 
exactly the same. It would still contain the code to check 
each element in an array and display the same kind of output. 
But the test it applies against each element in the array would 
be done by the code that you pass to it. 
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advanced functions 


You need to tell fiwd() the name of a function 


Imagine you take our original search condition and rewrite it as a 
function: 

int sports_no_bieber(char *s) 

{ 

return strstr(s, "sports") && !strstr(s , "bieber"); 


I want someone into 
sports, but definitely 
not into Bieber... 


O 


0 


Now, if you had some way of passing the name of the function 
to find () as a parameter : you’d have a way of injecting the test: 


-fuhd*tioy\—) 

rwaidh v/ould spedi-fy 七 he 

o( -the 

七 he 七《七 . 


void find( 

{ 

int i ; 

puts("Search results:"); 

puts (’▼ - 

for (i = 0; i < NUM ADS; i++) 


)； 


if ( dall -- (ADS [i] ) ) { 

printf (” ％ s\n\ ADS [i] ) ;Hcvc, you'd sor^ way o*f dallmj 
} "the -Pu^dtio^ whose y\^n\c was ^ivert by 

"the irwa-t^h pavarwetev. 


puts( n 


If you could find a way of passing a function name to find (), 
there would be no limit to the kinds of tests that you could make in 
the future. As long as you can write a function that will return true 
or false to a string, you can reuse the same find () function. 



find(sports—no_bieber); 
find(sports_or_workout); 
find(ns_theater); 
find(arts theater or dining); 


But how do you say that a parameter stores the 
name of a function? And if you have a function 
name, how do you use it to call the function? 
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function pointers 


Every fuwctiow name is a pointer to the fuwetiow. 


You probably guessed that pointers would come into 
this somewhere, right? Think about what the name of 
a function really is. It’s a way of referring to the piece 
of code. And that’s just what a pointer is: a way of 

referring to something in memory. 

That’s why, in G, function names are also pointer 
variables. When you create a function called 
go_to_warp_speed (int speed), you are also 
creating a pointer variable called go_to_warp_speed 
that contains the address of the function. So, if you give 
find () a parameter that has a function pointer type, you 
should be able to use the parameter to call the function it 
points to. 



int go_to_warp_speed(int speed) 

{ 

dilithium_crystals(ENGAGE); 
warp = speed; 

reactor core {c, 125000 * speed. 


PI) 


clutch(ENGAGE); 
brake(DISENGAGE); 
return 0; 

} S a 


same 


/go to warp speed" 


The poih-teir doh-bihs the 

add 浐 ess o*f the -fuh^-tioh. 


go_to_warp_speed(4); 

you tall tiie you a\re 

us'm^ fom 七 ev. 


~4 


Let’s look at the C syntax you’ll need to work 
with function pointers. 
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advanced functions 


..but there's wo function data type 

Usually, it’s pretty easy to declare pointers in G. If you have a 
data type like int, you just need to add an asterisk to the end 
of the data type name, and you declare a pointer with int *. 

Unfortunately, G doesn’t have a function data type, so you 
can’t declare a function pointer with anything like function *. 

int *a; ^ 一 Tins dctlav"CS 

function *f; ^ — ...bui -this dcdlavc a pomiev. 

Why doesn't C have a function data type? 

G doesn’t have a function data type because there’s not just 
one type of function. When you create a function, you can vary a 
lot of things, such as the return type or the list of parameters it 
takes. That combination of things is what defines the type of the 
function. 


int go to warp speed(int speed) 



l/ 


TV^cv-c a\rc 

七 -types bcdausc V^avc 

\reiu 作 tyfes a^d fa^ramcWs. 


char** album names(char *artist, int year) 


So, for function pointers, you’ll need to use slightly more complex 
notation... 
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create a function pointer 


How to create fuwctiow pointers 


Say you want to create a pointer variable that can store 
the address of each of the functions on the previous page. 
You’d have to do it like this: 


int (*warp_fn) (int); 
warp_fn = go—to 一 warp—speed ; 
warp fn(4); 





TVis vAll trtaic a variable died 

addv-Tss 一，一 s—() 


This is just like dallihg 30 一 to 一 wavp 一 sp ee d (午) . 


char** (*names fn)(char*,int); 


r names fn = album names; 

- - 

char** results = names fn("Sacha Distel ", 


This will dv-catc d vd\ri^ble ulled 

that stove the address 
d alburh__harwcsO -Puh^tioh. 


1972); 


That looks pretty complex, doesn’t it? 

Unfortunately, it has to be, because you need to tell G the 
return type and the parameter types the function will take. 
But once you’ve declared a function pointer variable, you 
can use it like any other variable. You can assign values 
to it, you can add it to arrays, and you can also pass it to 
functions... 

...which brings us back to your find () code... 



Dumb Quest! 


9ns 


What does char** mean? Is it a typing error? 


char * * is a pointer normally used to point to an 
array of strings. 
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advanced functions 


Take a look at those other types of searches that people have asked for. See if you can create a 
function for each type of search. Remember: the first is already written. 

ExeRciSe 

,int sports no bieber(char *s) 

SomcohC who likes ^ 

sports but hot Bicbcv return strstr(s' ’ ’sports’ 1 ) && !strstr(s' "bieber"); 

} 

int sports or workout (char *s) 

\ -- 

一 • ' } 

' U)an-t a non- I int ns_theater (char *s) 

SnooKer uoho ( 

liKes -the 

■thea-ter. } 

find someone f int arts_theater_or—dining(char *s) 
uoho \v^es | { 一 一一 

arts ； theater ； 

rz 11 

Then, see if you can complete the find () function: 

Will 扒 ccd a 

void find( . ) ^ fomW ^assm^ 

{ -to \i tailed 

int i ; 

puts ("Search results:’ 1 ); 

puts (’▼ - "); 

for (i = 0; i < NUM—ADS; i++) { 

if (match (ADS [i] ) ) { 4 -- This will dall r^atdhO 

printf ( n %s\n n , ADS [i] ) ; -Puhdtioh that was passed ih. 

} 

} 

puts (’▼ - "); 

} 
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exercise solved 



SoLutlOH /r 

Sor^cohC who likes ' 
spo\rts but hot Bicbcv* 


You were to take a look at those other types of searches that people have asked for and create a 
function for each type of search. 


int sports no bieber(char *s 


return strstr (s , "sports") && !strstr (s , "bieber"); 


fvncVsoro' 

uoV^o Vv^ 

spo 办 0 r 





I u) 0 n-t 0 non - 
SonoKer u)ho 
liKes -the 
■thea-ter. 

find someone 
uoho \v^es 七 he 
arts ； theater ； 
or d-invno^. 


int sports_or_workout(char *s) 

{ 

rC'tuX'h s*ty ； s-t^(s) w spo\r*ts^) (I st)rs-tv ； (s ; u y/o\rkmj ou^O ； 

} 

int ns_theater(char *s) 

{ 

rc.iuv：n si)rs*!t\r(s ; W |K(£ W ) f f ，七 V?iv (. s 人 . 

} 

int arts_theater_or_dining(char *s) 

{ 

\rc*tu\rh s*brs-|t\r(s ; w a)r*b W ) || st\rst\r(s, : 七 |^ 也 > ： ’.7.11.. 如如认 4:—)^3 ::彳 


Then, you were to complete the find () function: 

void find( 

{ . 

int i ; 

puts("Search results:"); 

puts (’▼ - "); 

for (i = 0; i < NUM—ADS; i++) { 

if (match(ADS[i]) ) { 

printf ( f, %s\n f, , ADS [ i]); 

} 

} 

puts (’▼ - "); 
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advanced functions 



Tesr DriVq 


Let’s take those functions out on the road and see how they 
perform. You’ll need to create a program to call find () with 
each function in turn: 


int main() 

{ 

find(sports_no_bieber); 
find(sports_or—workout); 
find(ns_theater); 
find(arts_theater_or_dining); 
return 0; 



I File Edit Window Help FindersKeepers 


> ./find 
Search results : 


TWis is -f ma(spov*b^o_b*icb^). 


This is -P*md(spo\rts _o\r__y/o\rkou't). 



William: SBM GSOH likes sports , TV, dining 
Josh: SJM likes sports, movies and theater 


Search results : 


William: SBM GSOH likes sports , TV, dining 
Mike: DWM DS likes trucks , sports and bieber 
Peter : SAM likes chess, working out and art 
Josh: SJM likes sports , movies and theater 


Search results : 


TWis is 一七 kaW). • 〜 ^ 


Matt: SWM NS likes art, movies, theater 


This is kd ( 釙饮一 ov* 一 dih—. 




Search results : 


William: SBM GSOH likes sports , TV, dining 
Matt: SWM NS likes art, movies, theater 
Luis: SLM ND likes books, theater , art 
Josh: SJM likes sports , movies and theater 
Jed: DBM likes theater , books and dining 



Each call to the find () function is performing a very 
different search. That’s why function pointers are one of the 
most powerful features in G: they allow you to mix functions 
together. Function pointers let you build programs with a lot 

more power and a lot less code. 
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go huntin’ 



The Hunter’s Gul^e f^ Function P4i^ers 


When you’re out in the reeds, identifying those function pointers can be pretty 
tricky. But this simple, easy-to-carry guide will fit in the ammo pocket of any C user. 


Return type 


Pointer variable 

)( 

Param types 

) 


.... : .s. : .s... : ■拳 a< 


char** (*names fn)(char*,int) 


TW»s \s i\\t v^amc oi *bV^c 
vav*»aWc youVc dtt\ar\^ 



If function pointers are just 
pointers, why don’t you need to prefix 
them with a * when you call the 
function? 

You can. In the program, instead of 
writing match (ADS [i] ), you could 
have written (*match) (ADS [i]). 


And could I have used & to get 
the address of a method? 

Yes. Instead of 

find(sports_or_ 
workout) , you could have written 

find(&sports or workout). 


Then why didn’t I? 

Because it makes the code easier 
to read. If you skip the * and &， C will still 
understand what you’re saying. 
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fret it sorted with the C Standard Library 

Lots of programs need to sort data. And if the data’s 
something simple like a set of numbers, then sorting is 
pretty easy. Numbers have their own natural order. But it’s 
not so easy with other types of data. 

Imagine you have a set of people. How would you put 
them in order? By height? By intelligence? By hotness? 



When the people who wrote the G Standard Library 
wanted to create a sort function, they had a problem: 


How could a sort function sort any type of 
data at all? 


you are here ► 


325 


sorting 


Use fuwctiow pointers to set the order 


You probably guessed the solution: the G Standard Library 
has a sort function that accepts a pointer to a comparator 
function, which will be used to decide if one piece of data 

is the same as, less than, or greater than another piece 
of data. 


This is what the qsort () function looks like: 7\ IS is a fomtev" 

■to av\ av-v-ay. 

TV^'is "is s'iz^ 


qsort(void *array, 
TJjis is ihe —^ s i Z e t length. 


o( -the av-v-ay. 


size t item size , 


clcw>cir\*t 3 v-v-ay* 



Rcmcmbcv-, d Void* 
tbri fo’m 七 *to 


int (*compar)(const void *, const void *))； 

个 


This is a pom-tc^r b> a -Pu^dioh ihal dompaves iwo i-tc^s ir> -the avray. 


The qsort () function compares pairs of values over and 
over again, and if they are in the wrong order, the computer 
will switch them. 


And that’s what the comparator function is for. It will tell 
qsort () which order a pair of elements should be in. It 
does this by returning three different values: 


+ye 



0 



H tke first value is greater tkan tke seconct 
value, it skoulct return a positive number. 


H tke first value is less tkan tke seconct 
value, it skoulct return a negative number. 



H tke two values are etjual, 
it skoulct return zero. 


To see how this works in practice, let’s look at an example. 
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parting IntsUp Cl^se 


Let’s say you have an array of integers and you want to sort them in 
increasing order. What does the comparator function look like? 



int scores[] = {543,323,32,554,11,3,112}; 

If you look at the signature of the comparator function that 
qsort () needs, it takes two void pointers given by void*. 
Remember void* when we used malloc () ? A void pointer can 
store the address of any kind of data, but you always need to cast 
it to something more specific before you can use it. 

The qsort () function works by comparing pairs of elements in 
the array and then placing them in the correct order. It compares 
the values by calling the comparator function that you give it. 


A void pointer 
voict^ can store 
a pointer to 
anytlving[. 


int compare scores(const void* score a, const void* score b) 


Values are always passed to the function as pointers, so the first thing 
you need to do is get the integer values from the pointers: 


/ou heed -to das-t the void 

"to dh poihtcv. 

TWis (Wsi ^ jets ml 
s-tov-cd at addv-css 兑一 b. 



*(int*)score_a; 
*(int*)score b; 


Then you need to return a positive, negative, or zero 
value, depending on whether a is greater than, less 
than, or equal to b. For integers, that’s pretty easy to 
do — you just subtract one number from the other: 


The comparator 
function returned the 
value -21. That means 11 
needs to be before 32. 


O 


0 


return a - b; ^ ^ a > ^ this is positive. a < b, this is 

negative. I-P a b arc equal, this is 


z^\ro. 


And this is how you ask qsort () to sort the array: 


qsort(scores, 7, sizeof(int), compare scores); 
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exercise 



ExeRciSe 


乙 0 「 士 in-teaep 

u)iih 

士 he smallest 


Sort irvte 乎 r 

scores ； u ) 咖 
-the \aro^es-l 
^vrs-l. 


sof \ We 

re o^\es 

m. 


Now it’s your turn. Look at these different sort descriptions. See if you can write a comparator 
function for each one. To get you started, the first one is already completed. 



int compare_scores(const void* score_a, const void* score—b) 

{ 

int a = *(int*)score_a; 
int b = *(int*)score—b; 
return a - b; 


int compare scores desc(const void* score a, const void* score b) 


typedef struct 
int width; 
int height; 

} rectangle; 


TKis is i\\t 

ve 匕 type- 


int compare areas (const void* a, const void* b) 
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Sort a 脱 
names in 
^Iphabe-tical 

Or<3^0r. C0S0— 


a 


W 七 : 


s or>C is vcally *tv-*idky. 

int compare names(const void* a, const void* b) 




a stirihg is a poihtcv io a 匕 hav", 
v/hat will a poihicv -fco i-fc be? 


s t 啊 (w，, K Vcn < o 


And finally: if you already had the compare_areas () and compare_names () functions, how would you write 
these two comparator functions? 



a lis-t 

nannes in reverse 

alphabe-tical 

order. Case- 
sensi-tix/e. 


int compare names desc(const void* a, const void* b) 
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exercise so/vec/ 



t°^S ExeRclSe 
W^SotutvOH 


乙 0 「 士 in-teaep 

u)iih 
士 he smalles-t 


Sort irvte 乎 r 

scores ； u ) 咖 
-the \aro^es-l 
炅 irs 七 


re o^\es 

m. 


Now it’s your turn. You were to look at these different sort descriptions and write a comparator 
function for each one. 



int compare scores (const void* score a, const void* score b) 


int a — . 
int b — . 
return a 


(int*)score_a; 
(int*)score_b; 

- b; 


a 

TWis is i\\t one (W bcW- 


int compare scores desc(const void* score a, const void* score b) 


m*t b 二决 (m 七决 ) sdo\re bi 


\rrtu\rh b — a ； 


l*f you subiv-adi ihc ^umbev-s 七 he oihev v/ay 
aground, you II \rcvc\rsc -the ov-dev o( -the "f mal sov 七 


typedef struct 
int width; 
int height; 

} rectangle; 


TKis is i\\t 
vctta^^lc type- 


int compare areas (const void* a, const void* b) 


Pivst Coy\^Ct 
*tiic fo'm*tcvs 
*t\ic 乙 ovre^t 



y}?. . 7 1 . 

•m 七 二 （ va->wid*th 决 ra->hci3h*t)i 

•m 七 av-ca^b ― (\rb->wid*th ^ rb - >hei^vt); 
Thcv>, use -the ^^ v-e*tuv-h a\rca_a - av-ca_b; 

Sub*tvad*t*ioir> 


Thch, daldulai 
the aveas. 
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Sort a lis 七 
names in 
^Iphabe-tioal 

Or<3^0r. C0S0— 


,1 


Wm*t: 

st 啊 W P^ W ) < o 


int compare_names(const void* a, const void* b) 

{ /\ sbr\^ is a pom-tcv- *to a cMar, so i\\t fo*m*tc\rs 

Y ouVcf 。…七二 

dhav；** sb =1 (dhar**)b ； 
v-c*tuv-h s*t\rdmp(^sa, 决 sb); 

} ^ heed -to use the ^ opeva-tov* 

"to ^ihd the dd~tudl S"tv"ihjs. 


And finally: if you already had the compare_areas () and compare_names () functions, how did you write 
these two comparator functions? 


Sort -the 

rec^ano^\es 
in area order) 
\aro^est Mrst. 


int compare areas desc(const void* a, const void* b) 


v-rtuv-h domparc^areasOD, a); 


K 


Ar you Could have used -dorwpa\rC__av-cas(«| ; b). 


^ort 8 lis-t 
n6iT)0S in r 0 \/ 0 rS 0 

alphabe-ticai 

order. Case - 
sensi-tix/e. 


int compare names desc(const void* a, const void* b) 


return Compare 一 a); 

} .… \ . . . 

Or you 匕 ould have used 

一匕 0 叫巧代一的 amesfa ， b). 


o 


Don’t worry if this 
exercise caused you a 
few problems. 

It involved pointers, 
function pointers, and even a little math. If 
you found it tough, take a break, drink a little 
water, and then try it again in an hour or two. 
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test drive 



Tesr DriVq 


Some of the comparator functions were really pretty gnarly, so it’s 
worth seeing how they run in action. This is the kind of code you 
need to call the functions. 







int main() 

{ 

int scores [] 
int i ; 


{543,323,32,554,11,3,112}; 


TV^is is I'mc 

*tV>a*b sorb _^ qsort (scores f 7 , sizeof (int) , compare—scores—desc); 

stores. puts ("These are the scores in order :”）； 

i\\t ov-dev- o\ 

clcw\cir\*ts m av-v-ay* 


This will pv-iht out 
the a\r\ray or\tt 
its bcch so\rtcd. 


TWis sov-b 

T 

av-vay ^amcs 
is just ^ array 
o\ ^av- fo'm-tev-s, 
so SIZ^ of 
is 


scores[i]); 


for (i = 0; i < 1 
printf("Score = 

} 

char *names[] = {"Karen", "Mark" , "Brett ", "Molly"}; 

^ qsort(names, 4, sizeof(char*), compare names); 
puts(^hese are the 讎 es m order: ”）； — 
for (i = 0; i < 4; i++) { 

printf( n %s\n n , names[i]); 兮 〜 TWis fv-'mts i)nt soritd ^ts out- 

return 0; 
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If you compile and run this code, this is what you get: 


| File Edit Window Help Sorted 


> ./test drive 


These 

are the scores in order : 


Score 

= 554 


Score 

= 543 


Score 

= 323 


Score 

=112 


Score 

= 32 


Score 

=11 


Score 

= 3 


These 

Brett 

Karen 

Mark 

Molly 

> 

are the names in order : 



Great, it works. 

Now try writing your own example code. The sorting 
functions can be incredibly useful, but the comparator 
functions they need can be tricky to write. But the more 
practice you get, the easier they become. 



I don’t understand the comparator 
function for the array of strings. What 
does char** mean? 

Each item in a string array is 
a char pointer (char*)_ When 
qsort () calls the comparator function, 
it sends pointers to two elements in 
the arrays. That means the comparator 
receives two pointers-to-pointers-to-char. 

In C notation, each value is a char* *■ 



OK, but when I call the 
strcmp () function, why does the 
code say strcmp (*a, *b) ? Why 
not strcmp (a, b) ? 

a and b are of type char*' The 
strcmp () function needs values of 
type char' 


Does qsort () create a sorted 
version of an array? 

It doesn’t make a copy, it actually 
modifies the original array. 

Why does my head hurt? 

Don’t worry about it. Pointers are 
really difficult to use sometimes. If you 
don't M them a little confusing, it probably 
means you aren’t thinking hard enough 
about them. 
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dear john 


Automating the Pear John letters 


Imagine you’re writing a mail-merge program to send out 
different types of messages to different people. One way of 
creating the data for each response is with a struct like this: 


丁 hese th'rcc types o( messages 

will be Str\i *to people. 




enum response type {DUMP, SECOND 一 CHANCE, MARRIAGE}; 

typedef struct { 
char ^name; 



enum response 一 type 

response; 


The enum gives you the names for each of the three types of 
response you’ll be sending out, and that response type can be 
recorded against each response. Then you’ll be able to use 
your new response data type by calling one of these three 
functions for each type of response: 


void dump(response r) 

{ 

printf("Dear %s,\n n , r.name); 

puts("Unfortunately your last date contacted us to"); 
puts("say that they will not be seeing you again"); 

} 

void second—chance(response r) 

{ 一 

printf("Dear %s,\n n , r.name); 

puts("Good news : your last date has asked us to"); 
puts("arrange another meeting. Please call ASAP. n ); 

} 

void marriage(response r) 

{ 

printf("Dear %s,\n n , r.name); 

puts ("Congratulations! Your last date has contacted"); 
puts("us with a proposal of marriage. n ); 


So, now that you know what the data looks like, and you have 
the functions to generate the responses, let’s see how complex 
the code is to generate a set of responses from an array of data. 
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aa] Puzzjc 


Take code fragments from the pool and place 
them into the blank lines below. Your 
goal is to piece together the main () 
function so that it can generate a set 
of letters for the array of response 
data. You may not use the same code 
fragment more than once. 


int main() 

{ 

response r[] = { 

{"Mike", DUMP}, {"Luis", SECOND_CHANCE}, 
{ n Matt n , SECOND—CHANCE}, {"William", MARRIAGE} 

}； 一 
int i ; 

for (i = 0; i < 4; i++) { 

switch( ) { 

case : 

dump( ); 

break; 

case : 

second—chance( ); 

break; 
default : 


marriage( 


return 0; 

} 

Note: each thing from 
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out of the pool 



Paa] puzz]c 

Take code fragments from the pool and place 
them into the blank lines below. Your 
goal was to piece together the main () 
function so that it can generate a set of 
letters for the array of response data. 


int main() 
{ 


Call 如 method *fov- 
eddV) -type- 


response 

r[] = { 



{"Mike’ 

▼, DUMP}, 

{"Luis", 

SECOND CHANCE}, 

{"Matt f 

\ . 

SECOND 

CHANCE } , 

{ "William", MARRIAGE } 

1 r 

int i ; 
for (i — 

0; i < 4; 

i + +) { 

Loofm^ av-v-ay 



switch (.r[i].type.) 

case DUMP : 

dump ( r[i] ) 

break; 

case SECOND^CHANCE : 

second—chance ( 
break; 
default : 


+ Tcstmj -the -type -field ea 乩七 im 


r[i] 


marriage 


r[i] 


return 0; 


Note: each thing from 
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Tesr DriVq 


When you run the program, sure enough, it generates the 
correct response for each person: 


File Edit Window Help DontForgetToBreak 


./send 一 dear_johns 
Dear Mike, 

Unfortunately your last date contacted us to 
say that they will not be seeing you again 
Dear Luis, 

Good news : your last date has asked us to 
arrange another meeting. Please call ASAP. 
Dear Matt, 

Good news : your last date has asked us to 
arrange another meeting. Please call ASAP. 
Dear William, 

Congratulations! Your last date has contacted 
us with a proposal of marriage. 

> J J 


Well, it’s good that it worked, but there is quite a lot of code 
in there just to call a function for each piece of response 
data. Every time you need call a function that matches a 
response type, it will look like this: 

switch(r.type) { 
case DUMP : 
dump(r); 
break; 

case SECOND—CHANCE: 
second—chance(r); 
break; 
default : 

marriage(r); 


And what will happen if you add a fourth response 
type? You’ll have to change every section of your 
program that looks like this. Soon, you will have a lot 
of code to maintain, and it might go wrong. 

Fortunately, there is a trick that you can use in G, 
and it involves arrays … 



They told me a 
coder forgot a set of 
break statements, and 
that meant I ended up 
with this guy... 
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function pointer arrays 


Create aw array of fuwctiow pointers 

The trick is to create an array of function pointers that match 
the different response types. Before seeing how that works, let’s 
look at how to create an array of function pointers. If you had an 
array variable that could store a whole bunch of function names, 
you could use it like this: 

replies[] = {dump, second chance f marriage}; 


But that syntax doesn’t quite work in G. You have to tell the 
compiler exactly what the functions will look like that you’re 
going to store in the array: what their return types will be and 
what parameters they’ll accept. That means you have to use this 

much more complex syntax: 


The vav-'iable v/ill be And it s 的。 七 jus 七占 -Pu^ftio^ po’nrtev*; 
c , p , dalled w v-cpI*ics. w 1 仏為 whole av*\ray o( iherw. 

fc 沉 h ih ^ ^ 

the avvay will bevoid (*replies []) (response) ={dump, second—chance, marriage}; 
3i void — 


； iOh. 


/ 


\ \ 



Return type 

(玲 

Pointer variable 

)( 

Param types 

) 


Jus*t ov\t 

type Vcspor\sc/ 


个 

Pcdlav-*mg a +ur>d*t'io^ 
pom*tcv* (av*vay). 


/t 


Now you Ye dov\c ihc variable, and i 仏 -time b> 

say wha 七 pavame 七 e\rs cath 七 will -take. 


Put how does an array help? 


Look at that array. It contains a set of function names that are in 

exactly the same order as the types in the enum: 


enum response type {DUMP , SECOND CHANCE , MARRIAGE}; 


This is really important, because when G creates an enum, it gives 
each of the symbols a number starting at 0. So DUMP ==0 ， 
SECOND—CHANCE == 1, and MARRIAGE == 2. And that’s really 
neat, because it means you can get a pointer to one of your sets 
of functions using a response—type: 


This is 
a^ray 


youv- ^ replies [SECOND 一 CHANCE] == second 一 chance 

or -ru^d-tio^s. 

S£COKD__CHAKCE has -the value I. 



Its e<\ual bo *tV\c 


Let’s see if you can use the function array to 
replace your old main() function. 
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OK, this exercise is quite a tough one. But take your time with it, 
and you should be fine. You already have all the information you 
need to complete the code. In this new version of the main () 
function, the whole switch/case statement used before has 
been removed and needs to be replaced with a single line of 
code. This line of code will find the correct function name from 
the replies array and then use it to call the function. 


void (^replies [ ]) (response) = {dump, second chance, marriage}; 


int main() 

{ 

response r[] = { 

{"Mike", DUMP}, {"Luis", 
{"Matt", SECOND—CHANCE}, 

}； 

int i ; 


for (i = 0; i < 4; i++) { 


SECOND—CHANCE}, 
{▼▼William” ， MARRIAGE} 


return 0; 
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mainQ updated 


— i^^irpen your pencil 


OK, this exercise was quite a tough one. In this new version of 
the main () function, the whole switch/case statement 
used before was removed, and you needed to replace it. This line 
of code will find the correct function name from the replies 
array and then use it to call the function. 


void (^replies [ ]) (response) = {dump, second chance, marriage} 


int main() 

{ 

response r[] = { 

{ n Mike n , DUMP}, {"Luis" 
{"Matt", SECOND CHANCE} 


SECOND—CHANCE}, 

{"William", MARRIAGE} 


int 


for (i = 0; i < 4; i++) 

^vcpJicsC\rCi 3 .*typc 3 )(\rCi 3)； 

} … •二 . 

— l-f you Y/Sr)icdj you CoM have added a 决 

return 0; a^cv- ihc bu-t \i v/ould 

v/o\rk -the same 


Let’s break that down. 


This x^/kole 七 is a 七 i 。 灼 

like ov* u mav*v'ia^c w 




TWs is youv avvay o( 
-fur>d*tiov> 


This is a value like 
O (or DU/V]P o\r Z 

(or marria^b. 


>uVc 

-fuir>d*tior> dir>d i*t 

-the vcspo^sc data v-C*i 3 . 
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Tqst DriVq 


Now, when you run the new version of the program, you get 
exactly the same output as before: 


File Edit Window Help WhoIsJohn 


> ./dear 一 johns 
Dear Mike, 

Unfortunately your last date contacted us to 
say that they will not be seeing you again 
Dear Luis, 

Good news : your last date has asked us to 
arrange another meeting. Please call ASAP. 
Dear Matt, 

Good news : your last date has asked us to 
arrange another meeting. Please call ASAP. 
Dear William, 

Congratulations! Your last date has contacted 
us with a proposal of marriage. 

> & = 


The difference? Now, instead of an entire switch statement, 
you just have this: 

(replies[r[i]•type])(r[i]); 


If you have to call the response functions at several places in 
the program, you won’t have to copy a lot of code. And if you 
decide to add a new type and a new function, you can just add 
it to the array: 

enum response_type {DUMP, SECOND—CHANCE, MARRIAGE, 
void (^replies[]) (response) = {dump, second chance 


LAW_SUIT}; 

marriage , 


You tav\ add 
^ 七 y? cs 

like 七 Wis. 

◊ 

law suit}; 


Arrays of function pointers can make your code much easier 
to manage. They are designed to make your code scalable by 
making it shorter and easier to extend. Even though they are 
quite difficult to understand at first, function pointer arrays 
can really crank up your G programming skills. 
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no dumb questions 


BULLET POINTS - 

■ Function pointers store the addresses of functions. 

■ The name of each function is actually a function pointer. 

■ If you have a function shoot () , then shoot and 
& shoot are both pointers to that function. 

■ You declare a new function pointer with 

return-type(^var-name) (param-types). 

■ If f p is a function pointer, you can call it with 

fp(params,...). 

■ Or, you can use (*fp) (params, . . .). C will work 
the same way. 


■ The C Standard Library has a sorting function called 

qsort (). 

■ qsort () accepts a pointer to a comparator function 
that can test for (in)equality. 

■ The comparator function will be passed pointers to two 
items in the array being sorted. 

■ If you have an array of data, you can associate functions 
with each data item using function pointer arrays. 


Why is the function pointer 
array syntax so complex? 

Because when you declare 
a function pointer, you need to say 
what the return and parameter types 
are. That’s why there are so many 
parentheses. 



This looks a little like the 
sort of object-oriented code in 
other languages. Is it? 

It's similar. Object-oriented 
languages associate a set of 
functions (called methods) with 
pieces of data. In the same way, you 
can use function pointers to associate 
functions with pieces of data. 


Hey, so does that mean that 
C is object oriented? Wow, that’s 
awesome. 

No. C is not object oriented, 
but other languages that are built on 
C, like Objective-C and C++, create 
a lot of their object-oriented features 
by using function pointers under the 
covers. 
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Make your fuwctiows strcGeecGtchy 

Sometimes, you want to write G functions that are YGdilly powerful, like your 
find () function that could search using function pointers. But other times, 
you just want to write functions that are easy to use. Take the printf () 
function. The printf () function has one really cool feature that you’ve 
used: it can take a variable number of arguments: 


printf("%i bottles of beer on the wall, %i 
printf("Take one down and pass it around, 
printf ("%i bottles of beer on the wall\n n . 

So how caw YOU do that? 

And you’ve got just the problem that needs it. Down in the Head First 
Lounge, they’re finding it a little difficult to keep track of the drink totals. 

One of the guys has tried to make life easier by creating an enum with the 
list of cocktails available and a function that returns the prices for each one: 

enum drink { 

MUDSLIDE, FUZZY—NAVEL, MONKEY_GLAND, ZOMBIE 

}； _ _ 

double price(enum drink d) 

{ 

switch(d) { 

case MUDSLIDE: 

return 6.79; 
case FUZZY—NAVEL: 

return 5.31; 
case MONKEY_GLAND : 

return 4.82; 
case ZOMBIE: 
return 5.89; 

} 

return 0; 

} 

And that’s pretty cool, if the Head First Lounge crew just wants the price of 
a drink. But what they want to do is get the price of a total drinks order: 

_v>umbcv* o( dv-'mks 

MONKEY GLAND, FUZZY NAVEL) ^ S ° 

/r— — cas v 

A list o( the d\rihks ih the o>rdtY 

the drinks and then a list of drink names. 


Easy —^price (ZOMBIE) total (3, ZOMBIE, 

They want a function called total () that will accept a count of 


bottles of beer\n n , 99, 99); 

98) u ddr> f>dss ds mair>y 

as you v\ttA *to 
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variadic functions 



Variable f uneti^ns Up Cl^se 


A function that takes a variable number of parameters is 
called a variadic function. The G Standard Library 
contains a set of macros that can help you create your 
own variadic functions. To see how they work, you’ll 
create a function that can print out series of ints: 


>u of rw3dv*os as d 

s^ed'ial -type o-f 七 10 灼 

»od'i+y youv souvtc dodc- 


rw< 


print_ints(3, 79, 101, 32); 

— f 

Numbcv o( mis *fco fvm 七 The mts that y\tt& io be pvmted 


Here’s the code: 


The variable TV variable av-^umert-b W\W start 

will -follow hcvc. a-f*tcv av-y pav-ametev- 


This is a y>ov*mal> ov-dmavy 
av^um ⑶七七 ha 七 v/ill always 
be passed- 


va__sta\rt says y/hc\rc 七 he 
vav-iablc s^tairt. 


This will loop 七 hv~ough all 
o( ihc oihc\r av-^urwe^ts. 

av-gs ^o^*ba'ms a 乙 ou 灼 *t 
o-f how \/av"iabks 
there are. 



Let’s break it down and take a look at it, step by step. 
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advanced functions 



Include the stdarg.h header. 

All the code to handle variadic functions is in stdarg.h, so you 
need to make sure you include it. 


Tell your function there's more to come... 

Remember those books where the heroine drags the guy 
through the bedroom and then the chapter ends “•••”？ Well, 
that is called an ellipsis, and it tells you that something 
else is going to follow. In G, an ellipsis after the argument of a 
function means there are more arguments to come. 


Mo } yjc do^*t v-cad 

•those books erthev-. 



Create a va_list. 

A va_list will be used to store the extra arguments that 
are passed to your function. 



Say where the variable arguments start. 

G needs to be told the name of the last fixed argument. In the 
case of our function, that’ll be the args parameter. 



Then read off the variable arguments, one at a time. 

Now your arguments are all stored in the va_list, you can read 
them with va_arg. va_arg takes two values: the va_list and 
the type of the next argument. In your case, all of the arguments 
are ints. 


- - ►© Finally ...end the list. 

After you’ve finished reading all of the arguments, you need to tell 
G that you’re finished. You do that with the va_end macro. 



Now you can call your function. 

Once the function is complete, you can call it: 


print ints (3, 79, 101 r 32); 

^ 一 

TVis y/ill p\rm*t ou 七刀 a 灼 d 孓上 values. 


you are here ► 


345 






no dumb questions 


Gee| Bits - 

Functions vs. macros 

A macro is used to rewrite your code before it’s compiled. The macros 
you’re using here (va—start, va_arg, and va—end) might look 
like functions, but they actually hide secret instructions that tell the 
preprocessor how to generate lots of extra smart code inside your 
program, just before compiling it. 


tWei^re no 

Dumb Qu 


Questions 


Wait, why are va_end and 
va_start called macros? Aren’t they 
just normal functions? 

No, they are designed to look like 
ordinary functions, but they actually are 
replaced by the preprocessor with other 
code. 


And the preprocessor is? 


The preprocessor runs just before 
the compilation step. Among other things, 
the preprocessor includes the headers into 
the code. 


Can I have a function with just 
variable arguments, and no fixed 
arguments at all? 

No. You need to have at least one 
fixed argument in order to pass its name to 

va_start. 

What happens if I try to read more 
arguments from va_arg than have 
been passed in? 

Random errors will occur. 


That sounds bad. 


Yep, pretty bad. 


What if I try to read an int 
argument as a double, or something? 


Random errors will occur. 
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advanced functions 



OK, now it’s over to you. The guys in the Head First Lounge want to create a function that can 
return the total cost of a round of drinks, like this: 


printf ("Price is %.2f\n n , total (3, MONKEY_GLAND, MUDSLIDE, FUZZY—NAVEL)); 

This will pv-'m-t U P\ridc is 


Using the price () from a few pages back, complete the code for total () : 


double total (int args,...) 


double total = 0; 


return total; 
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who^ paying? 



SoLutioH 


OK, now it’s over to you. The guys in the Head First Lounge want to create a function that can 
return the total cost of a round of drinks, like this: 


printf ("Price is %.2f\n n , total (3, MONKEY GLAND, MUDSLIDE, FUZZY NAVEL)) 




This y/i|| p\rm 七 W P\ridc is 


Using the price () from a few pages back, you were to complete the code for total () : 


double total (int args,... 


double total = 0; 


Dok / 七 v/ov-vy i-f 
you\r Code does〆 七 

look like . 

ihis. Thcvc avc ) 一 

a -Pew ways o*f 七 ( 彡 ] p,. 


it 




-fo\r(i O ； i < ar^sj i++) { . 

Chum dvmk d 二 va 3v*(\(ap. chum dv"mk)i 


*tp*tal ^ *tp*tal + p\ridc(d)i 


} 


va_chd(ap); 


return total 
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advanced functions 



Tqst DriVq 


If you create a little test code to call the function, you can 
compile it and see what happens: 


€ 


Tiiis is 七 es 七乙 ode. 


main () 


is 

%.2f\n n . 

total(2, 

MONKEY 

GLAND 

is 

%.2f\n n . 

total(3 , 

MONKEY 

GLAND 

is 

%.2f\n n . 

total(1, 

ZOMBIE)); 


MUDSLIDE)); 

MUDSLIDE, FUZZY NAVEL)) 


return 0; 



Your code works! 

Now you know how to use variable arguments to 
make your code simpler and more intuitive to use. 




BULLET POINTS 


■ 


■ 


■ 


■ 


Functions that accept a variable 
number of arguments are called 

variadic functions. 

To create variadic functions, you need 
to include the stdarg.h header file. 

The variable arguments will be stored 

in a va_list. 

You can control the va_list using 
va_start (), va_arg (), and 
va end(). 


■ 


■ 


■ 


You will need at least one fixed 
parameter. 

Be careful that you don’t try to read 
more parameters than you’ve been 
given. 

You will always need to know the data 
type of every parameter you read. 
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c toolbox 



Your C Toolbox 


You’ve got Chapter 7 under 
your belt，and now you’ve 
added advanced functions to 
your toolbox. For a complete list of 
tooltips in the book, see Appendix ii. 


Fuhd*tioh po*m*tcrs 
let you pass 
4*uhd*ti oy\s around 
as i-f -they 
daia. 


y/crc 


a 代枷 A 


...bui you 
s*till use *thcm i-f 
you waht "to. 


\s a 


^sov-tO 

will sor£ 
av-v-ay. 


^36^ sort 

^vAV\ 6 t»ov\ needs 
a ^o»v\*tcv* *to 

。 6 七、 0 灼 . 




/Ways J 4 hdtioi 

poihtcirs help 

浐 tm di-Pfcvchi 

-Puh(t*tiohs -fo^ 
di-Pfcvch-fe -types of 
地 . 


Com\>av-a*tov- 
-fuy\6*t»o^ s dcd'dc 
^ov/ *to order 
-tv/o ficdcs o^ 


fWW ^ a 

vdv*»aWc cv * 
o^f av^wcv\*ts avc 

tailed W 、 ad • 心 ” 


s+dairg.h le*ts 
you 6\rcate 

▽airiadi 匕 

-Puh^iiohS. 
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8 static and dynanifc lfccirfes 


^ Hot-swappable code ♦ 



You’ve already seen the power of standard libraries. 

Now it’s time to use that power for your own code. In this chapter, you’ll see how to create 
your own libraries and reuse the same code across several programs. What’s more, 
you’ll learn how to share code at runtime with dynamic libraries. You’ll learn the secrets 
of the coding gurus. And by the end of the chapter, you’ll be able to write code that you 
can scale and manage simply and efficiently. 


this is a new chapter 
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security library 


Code you can take to the bank 

Do you remember the encrypt () function you wrote a while 
back that encrypted the contents of a string? It was in a separate 
source code file that could be used by several programs: 


^include "encrypt.h' 


void encrypt(char ^message) 


while (^message) { 
^message = ^message 
message++; 

} 


void encrypt(char ^message) 




encrypt, h 


Somebody else has written a function called 


encrypt.c 


checksum () that can be used to check if 
the contents of a string have been modified. 
Encrypting data and checking if data has been 
modified are both important for security. 
Separately, the two functions are useful, but 
together they could form the basis of a 
security library. 


#include "checksum.h M 

int checksum(char ^message) 

{ 

int c = 0; 
while (^message) { 

c += c a (int) (^message); 
message++; 

} 

return c; 

} 


This \rctu\rhS a humbev- 

based ov\ the doh-tchts of a s-tv-ihg. 


int checksum(char ^message); 




checksum.h 


checksum.c 
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static and dynamic libraries 


A security library? Hey, 
thafs just what Tm looking 
for! The security at our 
bank is, well...kinda sloppy. 


%|l)arpen your pencil 



七 he 


Head o-f scdu\ri*ty 

o-f rtedd Piv"S*t. 

He also dlcar\s pools. 


The guy at the bank has written a test program to see how 
the two functions work. He put all of the source into the same 
directory on his machine and then began to compile it. 

He compiled the two security files into object files, and then 
wrote a test program: 


#include <stdio.h> 
#include <encrypt.h> 
#include 〈 checksum.h> 




I File Edit Window Help 



一 c encrypt.c 一 o encrypt.o 
-c checksum.c -o checksum.o 


int main() 

{ 

char s[] = n Speak friend and enter"; 
encrypt(s); 

printf("Encrypted to '%s'\n n , s); 
printf("Checksum is %i\n n t checksum(s)) 
encrypt(s); 

printf("Decrypted back to '%s'\n n , s); ’ 
printf("Checksum is %i\n n , checksum(s)) 
return 0; 

^ - 


y/ill 七 youv 

data, l-f you tall "»*t aym ， 

\i W\W 七 it 


And that’s when the problems started. When he compiled the program, 
something went badly wrong... 

I File Edit Window Help | 


> gcc test_code.c encrypt.o checksum.o -o test—code 

test_code.c:2:21: error : encrypt.h : No such file or directory 
test 二 code.c:3:22: error : checksum.h: No such file or directory 

> — 


Using a pencil, highlight which command or code made the compile fail. 
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<> for standard headers 


c^Sharpen your pencil 

Solution 


The problem is in the test program. All of the source files are 
stored in the same directory, but the test program includes the 
encrypth and checksum.h headers using angle brackets (< >). 


#include <stdio.h> 
#include 产 encrypt•h> 

#include \<checksum.h> 


int main() 

{ 

char s[] = "Speak friend and enter' 
encrypt(s); 

printf("Encrypted to '%s'\n n A s); 
printf("Checksum is %i\n n , checksum(s)) 
encrypt(s)/ 

printf ("Decrypted back to ' %s ' \n f, , s); 
printf("Checksum is %i\n n , checksum(s)) 
return 0; 


Angle brackets are for standard headers 

If you use angle brackets in an #include statement, the compiler 
won’t look for the headers in the current directory; instead, it will search 
for them in the standard header directories. 

To get the program to compile with the local header files, you need to 
switch the angle brackets for simple quotes 


s-tdio h is 一 ^- 

sWed ’m ^ 
oy\c o( -the 
sta^da^rd 
header 

div*e 匕 ■fcovies. 


Ko>M -the Code dompilcs dov-v-cd-tly. 
I 七 i\)t itsi *to 

u^cadablc- 


#include <stdio.h> 
#include "encrypt.h 


^include "checksum.h' 




dr\d av-c m 

same divet-tovy as pv-oya^. 
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I File Edit Window Help 


> gcc test_code.c encrypt.o chefcksum.o -o test—code 

> ./test_code 一 

Encrypted to 'Loz~t?ymvzq{? 〜 q{?zqkzm’ 

Checksum is 89561741 

Decrypted back to 'Speak friend and enter' 

Checksum is 89548156 

> … 


The \rctu\rhS di-Pfcv-Cht 

values -Po\r di-Pfcv-Cht s-t\rihjs. 


1 

Call'm^ cUry^iO 仏乂七 icm a stCov\A 

■time vc*tuv-r\s 















static and dynamic libraries 



Put what if you want to share code? 

Sometimes you want to write code that will be 
available to lots of programs, in different folders, 
all over your computer. What do you do then? 



Yeah, I gotta get security 
added to all these different 
programs. I don’t want a 
separate copy of the security 
code for each one... 


There are two sets of files that you want to share 
between programs: the .h header files and the 
.o object files. Let’s look at how you can share 
each type. 
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sharing headers 


Sharing .h header files 

There are a few ways of sharing header files between 
different G projects: 

Store them in a standard directory. 

If you copy your header files into one of the standard directories like 
/ usr/local/include, you can include them in your source code using 
angle brackets. 

^/o\a use 

#include <encrypt. h> ^ -files av-c m 


a^le bvatkc*b i-f youv 
a sta 灼 davd divet-tovy- 




Put the full pathname in your include statement. 

If you want to store your header files somewhere else, such as 
/ my_header_Jtles, you can add the directory name to your 
include statement: 



Root directory 



my_header_files 


#include "/my_header 一 files/encrypt•h" 

encrypt, h 

-1 
checksum.h 




You can tell the compiler where to find them. 

The final option is to tell the compiler where it can find your 
header files. You can do this with the -I option on gcc: 


gcc -I/my header files test code.c 


• 參* 


-o test code 


The -I option tells the gcc compiler that there’s another 
place where it can find header files. It will still search in all the 
standard places, but first it will check the directory names in 
the -I option. 


TV>*is -tells i\\t tomf'ilcv b> look 
header -files as well 


as -the s*tar>dav-d divcdWics. 
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static and dynamic libraries 


Share .0 object files by using the full pathname 


Now you can always put your .0 object files into some sort of 
shared directory. Once you’ve done that, you can then just add 
the full path to the object files when you’re compiling the 
program that uses them: 


I Root directory 
L D my_object_files 


gcc -1 /my_header_f lies tes t_code. c 
/my_ob ject 一 files/encrypt • o 
/my_object 一 files/checksum•o -o test—code 


1001 D| 
moiool 
— ooioiol 
ipioiij 

encrypt.o 


Msmg the -Pull io 

"the object -Piles meahs you 
y\ttd a sepav-ate dopy 
C pvojcd-t. 


/你丫 一 0 杜七一 f 1S a 

s*tovc *fov youv object 





checksum.o 


If you compile your code with the full pathname to the object 
files you want to use, then all your G programs can share the 
same encrypt.o and checksum.o files. 


Hmmm... Thafs OK if I just have 
one or two object files to share, but 
what if I have a lot of object files? I 
wonder if there's some way of telling 
the compiler about a bunch of them... 


Yes, if you create an archive of object 
files, you can tell the compiler about a 
whole set of object files all at once. 

An archive is just a bunch of object files wrapped up 
into a single file. By creating a single archive file of all 
of your security code, you can make it a lot easier to 
share the code between projects. 

Let’s see how to do it... 
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archives 


An archive contains .0 files 

# ■ mm 

Ever used a .zip or a .tar file? Then you know how 
easy it is to create a file that contains other files. That’s 
exactly what a .a archive file is: a file containing other 
files. 

Open up a terminal or a command prompt and 
change into one of the library directories. These are 
the directories like / usr/lib or C:\MinGW\lib that 
contain the library code. In a library directory, you’ll 
find a whole bunch of .a archives. And there’s a 
command called nm that you can use to look inside 
them: 


libl.a 



libmain.o libyywrap.o 


/ou y,oi have a libl.a oh youv- 你把 Ue, bu 七 

tav\ t\ry the Oh ahy o-thev- .a -file. 

This is 扣 3v*dhivc 

ddlled libl a. 


libmd'mo 


likyy^v-ap-o 


I File Edit Window Help SilencelnTheLibrary 


> nm libl.a 

libl.a (libmain .o) : 
00000000000003a8 s 

U 

0000000000000000 T 
00000000000003c0 S 




EH_frame0 
—exit 
—main 4 ^^ 
main.eh 


W T 一你 am” medr\s libma'm o 
匕 or\*tams a mamO 


U _yylex 

libl.a(libyywrap.o) : 
0000000000000350 s EH_frame0 
0000000000000000 T _yywrap 
0000000000000368 S _yywrap.eh 
> 一一 ^ 


The nm command lists the names that are stored 
inside the archive. The libl.a archive shown here 
contains two object files: libmain.o and libyywrap.o. 
What these two object files are used for doesn’t really 
matter; the point is that you can take a whole set of 
object files and turn them into a single archive file that 
you can use with gcc. 

Before you see how to compile programs using .a, let’s 
see how to store our encrypt.o and checksum .。 files in an 
archive. 
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static and dynamic libraries 


Create aw archive with the ar command 


The archive command (ar) will store a set of object files in 
an archive file: 


The \r medics 七 he a 
-Pile v/ill be ufdaied 
i-f ii already exists. ^ 


TKc s -tells av bo ortait 
a 於 mdc% ai Ac start o-f 

七 he a file. 


These arc the -Piles will b 

s-to\rcd ih the a\rdliivc. 

^ V 


ar -res libhfsecurity.a encrypt.o checksum.o 


t 



TKc t means 七 ha 七七 he aWive 
y/ill be dvca*tcd v/rtiiout any 
-feedback. 


/r 

This is -the hdme 

the .a -file -to c^caie. 


Did you notice that all of the .a files have names like 
lib <something>. a? That’s the standard way of 
naming archives. The names begin with lib because they 
are static libraries. You’ll see what this means later on. 



Make sure you always 
name your archives 
Hb<something>.a. 

W&tcll it! if y 0U clon^t name them 

this way, your compiler will 
have problems tracking them down. 


..then store the .a m a library directory 

Once you have an archive, you can store it in a library 
directory. Which library directory should you store it 
in? It’s up to you, but you have a couple of choices: 



You can put your .a file in a standard 
directory like /usr/local/lib. 

Some coders like to install archives into a standard 
directory once they are sure it’s working. On Linux, on 
Mac, and in Gygwin, the / usr/local/lib directory is a 
good choice because that’s the directory set aside for your 
own local custom libraries. 



Put the .a file in some other directory. 

If you are still developing your code, or if you don’t feel 

comfortable installing your code in a system directory, ^ 0^ most madhmes, you -to be ar> 

you can always create your own library directory. For admmisivaW {o ful ^i| C s m /usv/lodal/lib. 

example: /my—lib. 
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compile with -I 


Fiwally, compile your other programs 


The whole point of creating a library archive was so you 
could use it with other programs. If you’ve installed your 
archive in a standard directory, you can compile your 
code using the -1 switch: 


h-Pscdu\riiy id Is -the dompilev- -fco look 
•PoV " 扣 a\rdhivc called libh-Psc^uv-i-ty.a. 

gcc test_code.c -lhfsecurity -o test—code 

>r _ 

|<f youVc scvcv* 3 l 

you tBv\ sc*t scvcv-al -I options. 


Rcmcmbcv- bo list you\r souvdc 
-f iles bc-fovc youv —I libv"3v~ics. 


^ Do you meed a -I of*t*ioir>? 
I 七 defends oy\ v/Kcvc you 
f u 七 youv headev-s. 


Gan you see now why it’s so important to name your 
archive lib<something>.a? The name that follows the -1 
option needs to match part of the archive name. So if your 
archive is called lib awesome, a, you can compile your 
program with the -1 awe some switch. 

But what if you put your archive somewhere else, like 
/my_lib? In that case, you will need to use the -L option 
to say which directories to search: 


So, I need to look for 
libhfsecurity.a starting in 
the /my—lib directory. 


0 



gcc test_code.c -L/my_lib -lhfsecurity -o test—code 



6 ee} BifS 



The contents of the library directories can be very different from one machine to another. Why is that? It’s 
because different operating systems have different services available. Each of the .o files is a separate library. 
There’ll be libraries for connecting to the network, or creating GUI applications. 


Try running the nm command on a few of the .a files. A lot of the names listed in each module will match 

compiled functions that you can use: ^ 

meay>s w l ^ 此 ” v/hidii *tK'is is a -ruy>d*tioir>. 

0000000000000000 T _yywrap m w oUhe is yyw^fO. 


The nm command will tell you the name of each .o object file and then list the names that are available within 
the object file. If you see a T next to a name, that means it’s the name of a function within the object file. 
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static and dynamic libraries 


Make Magnets 



The security guy is having trouble compiling one of the bank programs 
against the new security library. He has his source code as well as the 
encrypt and checksum source code in the same directory. For now, he 
wants to create the libhfsecurity.a archive in the same directory and then 
use it to compile his own program. Can you help him fix his makefile? 


Note: the bank vault program uses these #include statements: 


#include <encrypt.h> 
#include 〈 checksum.h> 


This is the makefile: 


encrypt.o : encrypt.c 


gcc encrypt.c -o encrypt.o 


checksum.o : checksum.c 


gcc checksum.c -o checksum.o 


libhfsecurity.a : encrypt.o 


ar -res encrypt.o 


bank vault : bank vault.c 


gcc 




-o bank vault 
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make unpuzzled 


Make Magnets Solution 


The security guy is having trouble compiling one of the bank programs 
against the new security library. He has his source code, as well as the 
encrypt and checksum source code in the same directory. For now, he 
wants to create the libhfsecurity.a archive in the same directory and then 
use it to compile his own program. You were to help him fix his makefile. 

Note: the bank vault program uses these #include statements: 


This is the makefile: 


#include <encrypt * h> #mdludcs arc 

#include 〈 checksum.h> Will *to be *told 

七 he Redder -f iles av-c a -I 


encrypt. o : encrypt. c the objedt -Pile 


gcc 



checksum.o : checksum.c 


gcc 


0 



w- 〜 wwrcc Tile- 

NT 

encrypt.c -o encrypt.o 

This dveates i\\t objcd*t -Pv-om 
*thc dhcdksum d souvdc -Pile- 

checksum.c -o checksum.o 



bank vault : bank vault.c 



Y^ia Y\ccd -lh-Pscdu\ri-ty bemuse 七 he 
avdliivc is called libh-rscduv-i-ty.a. 


gcc 


个 

The pirogva^ s so^tc 

toAt -to be listed 

bcW the libv-av-y ^odc. 



-I 


_ … .Q …. 

- ，个 

y\tt& 一工 . bcfi-3usc 七 

headev" -Piles av-c m • 

(tuv-v-c^*t) div^W/. 


_L … Q …… 

个 W 

You heed -the - 
because the is m 

the ^uV-VCht di\rc^-fcov-y. 



o bank vault 


EE^El 


/usr/local/include 



/usr/local/lib 
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static and dynamic libraries 


BULLET POINTS - 

■ Headers in angle brackets (< >) are read from the 
standard directories. 

■ Examples of standard header directories are 
/usr/include and C:\MinGW\include. 

■ A library archive contains several object files. 

■ You can create an archive with ar -res 
libarchive.a fileO.o filel.o... 


Library archive names should begin lib. and end .a. 

If you need to link to an archive called libfred.a, 
use -Ifred. 

The -l flag should appear after the source files in 
the gcc command. 


D 


thereicire no 

)umb Qi] 


Questi9ns 


How do I know what the standard 
library directories are on my machine? 

You need to check the 
documentation for your compiler. On most 
Unix-style machines, the library directories 
include /usr/lib and /usr/local/lib. 

When I try to put a library archive 
into my /usr/lib directory, it won’t let me. 
Why is that? 

Almost certainly security. Many 
operating systems will prevent you from 
writing files to the standard directories in 
case you accidentally break one of the 
existing libraries. 


^Is 


the ar format the same on all 


systems? 


No. Different platforms can have slightly 
different archive formats. And the object 
code the archive contains will be completely 
different for different operating systems. 


If I’ve created a library archive, 
can I see what’s inside it? 

Yes. ar -t <filename> will 
list the contents of the archive. 

Are the object files in the archive 
linked together like an executable? 

No. The object files are stored in the 
archive as distinct files. 

Can I put any kind of file in a 
library archive? 

A: No. The ar command will check the 
file type before including it. 

Can I extract a single object file 
from an archive? 

Yes. To extract the encrypt.o 
file from libhfsecurity.a, use ar -x 

libhfsecurity.a encrypt.o. 


Why is it called “static” linking? 

Because it can’t change once it’s 
been done. When two files are linked 
together statically, it’s like mixing coffee 
with milk: you can’t separate them 
afterward. 

Should I use the HF security 
library to secure the data at my bank? 

That's probably not a good idea. 
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interview 



The LinKev Bxyosedi 


This week’s interview: 
What Exactly Do You Do? 


Head First ： Linker, thank you so much for making 
time for us today. 

Linker ： It's a pleasure. 

Head First: I’d like to begin by asking if you ever 
feel overlooked by developers. Perhaps they don’t 
understand exactly what it is you do? 

Linker ： I’m a very quiet person. A lot of people 
don’t talk to me directly with the Id command. 

Head First: id? 

Linker ： Yes? See, that’s me. 

Head First ： That 5 s a lot of options on my screen. 

Linker ： Exactly. I have a lot of options. A lot of 
ways of joining programs together. That’s why some 
people just use the gcc command. 

Head First: So the compiler can link files together? 

Linker: The compiler works out what needs to be 
done to join some files together and then calls me. 
And I do it. Quietly. You’d never know I was there. 

Head First ： I do have another question... 

Linker: Yes? 


Head First ： I hate to sound foolish, but what 
exactly is it you do? 

Linker ： That’s not a foolish question. I stitch pieces 
of compiled code together, a bit like a telephone 
operator. 

Head First: I don’t follow. 

Linker ： The old telephone operators would patch 
calls from one location to another so the two parties 
could talk. An object file is like that. 

Head First: How so? 

Linker ： An object file might need to call a function 
that’s stored in some other file. I link together the 
point in one file where the function call is made to 
the point in another file where the function lives. 

Head First ： You must have a lot of patience. 

Linker ： I like that kind of thing. I make lace in my 
spare time. 

Head First: Really? 

Linker: No. 

Head First ： Linker, thank you. 


364 


Chapter 8 


static and dynamic libraries 


The Head First frym is going global 


The guys at the Head First Gym are going to spread their 
business worldwide. They are opening up outlets on four 
continents, and each one will contain their trademarked 
Blood, Sweat, and Gears™ gym equipment. So they’re writing 
software for their ellipticals, treadmills, and exercise bikes. 
The software will read data from the sensors that are fitted 
on each device and then display information on a small LCD 
screen that will tell users what distance they’ve covered and 
how many calories they’ve burned. 





That’s the plan, anyway, but the guys need a little help. 
Let’s look into the code in a little more detail. 
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test the code 


Calculating calories 

The team is still working on the software, but they’ve got one 
of the key modules ready. The hfcal library will generate the 
main data for the LCD display. If the code is told the user’s 
weight, the virtual distance she’s traveled on the machine, and 
then a special coefficient, it will generate the basic LCD details 
on the Standard Output: 


^include <stdio.h> 

h > TKc deader file just do^*ta*ms a 
#inCludG <hfCal * h> ^ 缸 IwW oUhe a*,s P la Y ^alonesO WW. 

void display calories(float weight, float distance, float coeff) 


weight); 


The y/c'i^ivt »s *m pounds. 

printf("Weight: %3.2f lbs\n 
printf ("Distance: %3 .2 f miles\n n , distance) ; ^Tlic dis-tahde is \y\ miles. 

printf ("Calories burned : %4.2f cal\n", coeff * weight * distance); 


The team hasn’t yet written the main code for each piece of 
equipment. When they do, there will be separate programs for 
the ellipticals, treadmills, and exercise bikes. Until then, they’ve 
created a test program that will call the hfcal.c code with some 
example data: 


^include <stdio.h> 

#include <hfcal.h> 

The iesi usev weighs II^.Z 

int main() Pounds a,d has do, C 113 

^ilcs Oh the elliptical. 

{ 

display calories(115.2, 11.3, 0.79); 


return 0; 


pov* *bWis *tV>c 

toe 從|以扒七 on% 




This is ihe icsi dodc. 


elliptical.c 



TVis 乙 ode v/ill 

a -Pile called h-fda 


ih-fco 

U. 


hfcal.c 



TV LCP display Will 

七 S-ta^dav-d 0u*bfu-b. 


y/iII 


V 




U/QIGHT ： IIS .20 LBS 
DlSTOKQ ： )).30 muss 
GA 10 RIQS BtRUQD ： ) 023.39 CHI 


This is v/ha't "the 
looks like (or 七 he 
p\roj\rarw. 


个 


display 

icsi 
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static and dynamic libraries 



Now that you’ve seen the source code for the test program and 
the hfcal library, it’s time to build the code. 

Let’s see how well you remember the commands. 


1. Start by creating an object file called hfcal.o. The hfcal.h header is going 
to be stored in ./includes: 


2. Next, you need to create an object file called elliptical .。 from the 
elliptical.c test program: 


3. Now, you need to create an archive library from hfcal.o and store it in 
./libs: 


4. Finally, create the elliptical executable using elliptical .。 and the 
hfcal archive: 
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code built 


parpen your pencil 

Solution 


Now that you’ve seen the source code for the test program and 
the hfcal library, it’s time to build the code. 

Let’s see how well you remembered the commands. 


1. Start by creating an object file called hfcal.o. The hfcal.h header is going 

to be stored in ./includes: 〜 己 , ccds ^ k , ov/ ▲ 代七 he ^eade, f.le *.s. 

. .3“ .r.C. h^.CaU. .r:Q. .br^l'P . 

T ^ u 

Did you vcmcrwbcv -to add -the -I -flaa? 一匕 )必七 dveate ihc object -Pile ； do/t Imk it w 


2. Next, you need to create an object file called elliptical .。 from the 
elliptical.c test program: 


o^CC -X /*mdludcs -d elliptical-o cllip-ti^al o 

.t. 

you y>ccd *to -tell the dompilcv header art *m ./mdudes. 

3. Now, you need to create an archive library from hfcal.o and store it in 
•/libs: 

l,b,ra,r y ^ceds b> be earned lib....a. 

av 一 rds ./libs/libh^dal a h-fdal o 

. 不 … . 

TKc avdhivc y>ccds *fco m*to 七 he /libs div-cd*tovy- 

4. Finally, create the elliptical executable using elliptical .。 and the 

hfcal arch i ve : -l^dal ic\\s ihc do^pilcv- to look U libM^al.a. 

^Jr 

0jf,6 clliftidal o -L/libs - llvfdal -o elliptical 

.. 

Y^ouVe buildm^ *tv>c -L./libs 七 el Is 七 he dompilev wheve 七 he lib^ry is s-fcoved- 

elliptical. o dr>d *thc libvav-y. 

I File Edit Window Help SilencelnTheLibrary 

Now *tha*t you^ve built *the elliptical 

program, you t^y\ ruh i*t oy\ *the do^sole: 


> ./elliptical 
Weight : 115.20 lbs 
Distance : 11.30 miles 
Calories burned : 1028.39 cal 

> 
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Put things are a bit more complex... 

Turns out, there’s a problem. The Head First Gyms are expanding 
everywhere, in different countries that use different languages and 
different measures. For example, in England, the machines need to 
report information in kilograms and kilometers: 



ITqight ： & 3.2 & m 
Distoucs ： 1&.13 m 

CHL3RISS BtRUSD ： T5C.il2 CHL 



The gyms have lots of different types of equipment. If they have 20 
different types of machines, and they have gyms in 50 countries, that 
means there will be 1 } 000 different versions of the software. That’s a 
lot of different versions. 


And then there are other problems too: 


o 

o 

o 


If an engineer upgrades the sensors used on a machine, she might need to 
upgrade the code that talks to them. 

If the displays ever change, the engineers might need to change the code that 
generates the output. 

Plus many, many other variations. 


If you think about it, you get the same kinds of problems when you 
write any software. Different machines might require different device 
driver code, or they might need to talk to different databases or different 
graphical user interfaces. You probably won’t be able to build a version 
of your code that will work on every machine, so what should you do? 
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hold the anchovies 


Programs are made out of lots of pieces.. 


You’ve already seen that you can build programs using different 
pieces of object code. You’ve created .0 files and .a archives, 
and you’ve linked them together into single executables. 



but once they're linked, you can't change them 


The problem is that if you build programs like this, they are 
static. Once you’ve created a single executable file from 
those separate pieces of object code, you really have no way of 
changing any of the ingredients without rebuilding the whole 





The program is just a large chunk of object code. There’s no 
way to separate the display code from the sensor code; it’s 
all lost in the mix. 
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static and dynamic libraries 



— mm 










Wouldnt it be dreamy if there 
were a way to run a program using 
switchable pieces of object code? 
But I guess thafs just a fantasy... 
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static vs. dynamic 


dynamic linking happens at runtime 


The reason you can’t change the different pieces of object 
code in an executable file is because, well, they are all 
contained in a single file. They were statically linked 
together when the program was compiled. 


Rais'm ahd ahdhovy cakt 一 ^ 

\/cv-y *to v-emove jus*t v-aisms 



But if your program wasn’t just a single file — if your 
program was made up of lots of separate files that only 
joined together when the program was run — you would 
avoid the problem. 



IWes •… a s 吖 



The trick, then, is to find a way of storing pieces of object 
code in separate files and then dynamically linking 
them together only when the program runs. 

N^ou r\tt& *bo jom -files 

eddii twe {\\t pvoyam vur\s. 
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Caw you link .a at runtime? 

So you need to have separate files containing separate 
pieces of object code. But you’ve already got separate files 
containing object code: the .0 object files and the .a archive 
files. Does that mean you just need to tell the computer not 
to link the .0 files until you run the program? 

Sadly, it’s not that easy. Simple object files and archives 
don’t have quite enough information in them to be linked 
together at runtime. There are other things our dynamic 
library files will need, like the names of the other files they 
need to link to. 


dynamic libraries are object files on steroids 


So, dynamic libraries are similar to those .0 object files 
you’ve been creating for a while, but they’re not quite the 
same. Like an archive file, a dynamic library can be built 
from several .0 object files, but unlike an archive, the object 
files are properly linked together in a dynamic library to 
form a single piece of object code. 



Is it a bivd? Is it 
a pla^c? 1^1 o, i-t^s a — ^ 
v*clodol"tolblc 乙七 
file with 


TV>c 1'ibvav-y IS buil*t -fv-om 

OY\t OV move o -flics. 


A dy^amid libv-av-y c%*tva 

払 a 七七 k system Will 

{jo I'mk i\\t libyavy *to tWi 呼 . 

hi 七 he heart a dy^dmid 

libv-av-y is a si^le piede o( 
object Code- 


So how do you create your own dynamic libraries? 
Let’s see. 
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create an object file 


First create aw object file 

If you’re going to convert the hfcal.c code into a 
dynamic library，then you need to begin by compiling it 

into a .0 object file, like this: 一匕 mcar>s w p c ^*t I'mk *thc dodc w 

gcc -I/includes -fPIC -c hfcal.c -o hfcal.o 

个 \ 

Tk V^-fdaU is m /mdudes. I/VW does --fPIC mcar>? 


Did you spot the difference? You’re creating the hfcal.o 
exactly the same as before except you’re adding an 
extra flag: -f PIC. This tells gcc that you want to 
create position-independent code. Some operating 
systems and processors need to build libraries from 
position-independent code so that they can decide at 
runtime where they want to load it into memory. 


Now, the truth is that on most systems you don’t need to 
specify this option. Try it out on your system. If it’s not 
needed, it won’t do any harm. 


Position-inctepenctent 
code can te movect 
around in memory. 


< this! 


6ee| Bits - 

So, what is position-independent code? 

Position-independent code is code that doesn’t mind where the computer 
loads it into memory. Imagine you had a dynamic library that expected to 
find the value of some piece of global data 500 bytes away from where the 
library is loaded. Bad things would happen if the operating system decided 
to load the library somewhere else in memory. If the compiler is told to 
create position-independent code, it will avoid problems like this. 

Some operating systems, like Windows, use a technique called memory 
mapping when loading dynamic libraries, which means all code is 
effectively position-independent. If you compile your code on Windows, 
you might find that gcc will give you a warning that the -f PIC option is 
not needed. You can either remove the -f PIC flag, or ignore the warning. 
Either way, your code will be fine. 
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What you call your dynamic library depends oh your platform 


Dynamic libraries are available on most operating systems, and 
they all work in pretty much the same way. But what they’re 
called can vary a lot. On Windows, dynamic libraries are usually 
called dynamic link libraries and they have the extension 
.dll. On Linux and Unix, they’re shared object files (.so), 
and on the Mac, they’re just called dynamic libraries (.dylib). 


But even though the files have different extensions, you can 
create them in very similar ways: 

ov\ 

C C:\libs\hfcal.dll ^ 

)/libs/libhfcal • dll • a f cm l/V’mdov/s 

gcc -shared hfcal .o -o v 

/libs/libhfcal. so ov Uhix 

/libs/libhfcal. dylib /\/\^ 


The -shared option tells gcc that you want to convert a .0 
object file into a dynamic library. When the compiler creates 
the dynamic library, it will store the name of the library inside 
the file. So, if you create a library called libhfcal.so on a Linux 
machine, the libhfcal.so file will remember that its library name 
is hfcal. Why is that important? It means that if you compile a 
library with one name, you can’t just rename the file afterward. 


If you need to rename a library, recompile it with the new name. 


Compiling the elliptical program 

Once you’ve created the dynamic library, you can use it just like 
a static library. So, you can build the elliptical program like 
this: 


gcc -I\include -c elliptical.c -o elliptical.o 
gcc elliptical.o -L\libs -lhfcal -o elliptical 


Even though these are the same commands you would use 
if hfcal were a static archive, the compile will work differently. 
Because the library’s dynamic, the compiler won’t include the 
library code into the executable file. Instead, it will insert some 
placeholder code that will track down the library and link to it at 
runtime. 

Now ， let’s see if the program runs. 



On some older 
Mac systems, 
the -shared flag 
is not available. 


But don’t worry, on 
those machines, if you just replace 
it with - dynamic lib, everything 
will work exactly the same way. 


Library names in 
MinGW and Cygwin 

Both MinGW and Cygwin let you 
use several name formats for 
dynamic libraries. The hfcal library 
can have any of these names: 

I i bhfcal.dll. a 

libhfcal.dll 

hfcal.dll 
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test drive 



Tesr DriVq 


You’ve created the dynamic library in the / libs directory and built the 
elliptical test program. Now you need to run it. Because hfcal isn’t in 
one of the standard library directories, you’ll need to make sure the 
computer can find the library when you run the program. 

Oh a Mac 

On the Mac, you can just run the program. When the program is 
compiled on the Mac, the full path to the /libs/libhfcal.dylib file is stored 
inside the executable, so when the program starts, it knows exactly where 
to find the library. 


File Edit Window Help I mAMac 


> ./elliptical 
Weight : 115.20 lbs 
Distance : 11.30 miles 
Calories burned : 1028.39 cal 

> 




Mae. 


Ow Linux 

That’s not quite what happens on Linux. 

On Linux, and most versions of Unix, the compiler just records the 
filename of the lib hfcal. so library, without including the path name. That 
means if the library is stored outside the standard library directories (like 
/ usr/lib), the program won’t have any way of finding the hfcal library. To 
get around this, Linux checks additional directories that are stored in the 
LD LIBRARY PATH variable. If you make sure your library directory 
is added to the LD_LIBRARY_PATH — and if you make sure you 
export it — then elliptical will find libhfcal.so. 


0a Li 仙乂 ， you tittd "fco set 

LD__L|BRARylPATtt 

vaHablc so the pvogvarh 
乙 ^ihd the libv-avy. 

个 

Thcvc^s Y\0 Y\ttA *to do *th*is 
i-P -tKc libv-avy is somc>wiicv-c 
s*tay>dav-d, like / usv/lib. 


You Y\tt& *to make suVC 
i\\t vav-idble is 


File Edit Window Help I mLinux 


> export LD 一 LIBRARY 一 PATH=$LD—LIBRARY_PATH:/libs 

> ./elliptical 一 — 

Weight : 115.20 lbs 
Distance : 11.30 miles 
Calories burned : 1028.39 cal 

> 


今 


376 Chapter 8 











static and dynamic libraries 


On Windows 

Now let’s take a look at how to run code that’s been compiled using the 
Gygwin and Min GW versions of the gcc compiler. Both compilers 
create Windows DLL libraries and Windows executables. And just like 
Linux, Windows executables store the name of the hfcal library without 
the name of the directory where it’s stored. 

But Windows doesn’t use a LD_L I BRARY_PATH variable to hunt the 
library down. Instead, Windows programs look for the library in the 
current directory, and if they don’t find it there, the programs search for 
it using the directories stored in the PATH variable. 

Using Cygwiw 

If you’re compiled the program using Gygwin, you can run the program 
from the bash shell like this: 


I File Edit Window Help I’mCygwin 


> PATH= n $PATH:/libs" 

> ./elliptical 
Weight : 115.20 lbs 
Distance : 11.30 miles 
Calories burned : 1028.39 cal 

> 


( VVmdoy/s us'm^ Cy— 扒 


Using MiwW 

And if you’ve compiled the program using the Min GW compiler, you 
can run it from the command prompt like this: 


I File Edit Window Help I'mMinGW 


C:\code> PATH= n %PATH% : C : \libs" 
C : \code> ./elliptical 
Weight : 115.20 lbs 
Distance : 11.30 miles 
Calories burned : 1028.39 cal 
C : \code> 


l/Vir>dows tA\y\6{\N 


Does this seem a little complex? It is, which is why most programs that 
use dynamic libraries store them in one of the standard directories. 
That means on Linux and the Mac, they are normally in directories 
like / usr/lib or / usr/local/lib., and in Windows, developers normally keep 
•DLLs stored in the same directory as the executable. 
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exercise 



ExeRciSe 


The guys at the Head First Gym are about to ship a treadmill over to England. The embedded 
server is running Linux, and it already has the US code installed. 


The tech guys installed the library in 
/usr/local/lib. 


TWis is 


/usv/lotal/l'ik -foldcv-. 


/ 


□ 


/usr/local/lib 


Thcirc art lots o-thc^* 
ih hcv-c as well. ^ 


And this machine also has the header 
file for the hfcal library installed in 
/usr/local/include: 

TK*,S *.s -tKc /usir/lotal/rntludc (o\dcr- 


Cl 

o 

_□ 

ii^oTbi 
IiiioioJ 
looiof J 

llOlQlljJ 


loot bj 
iiioioJ 
ooioun 
loionjJ 

looiiDj 

iiioioJ 

ooioiol 

lOIOIIj) 

iooi bi 
iiioioJ 

OOIOICM 

loiomj 


common-lisp 


python2.7 


python4.2 


site—ruby 


libfluxcap.a 


libfluxcap.la 


libhfcal.so 


libmrfusion.so 


TWis is y/V)C\rC K-fdal 
libv-avy 'ms*tallcd. 



Thc\rc a\rc lots o( othcv- 
-Pilcs ih hcv-c -too. ^ 


/usr/local/include 


python2.7 



Q 

iiooi Dj 
llOlQlljJ 


python4.2 


fluxcap.h 


\oo\ bj 

ooioiol 

loionjJ 

iooi bi 
iiioioJ 
ooioiol 
iqioihJ 

l^oTbj 

IHOloJ 

ooioiol 

lOIOIlJ 


hfcal.h 


TWis »s 


-bKc Vvftal Kcadcv* Ale. 


mrfusion.h 


bwanalyze.h 


The tech guys like to install libraries using these directories because it’s a little more 
standard. The machine is all configured for use in the US, but things need to change. 
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static and dynamic libraries 


The system needs to be updated for use in the gym it is being shipped to in England. That means the 
treadmill’s display code needs to be switched from miles and pounds to kilometers and kilograms. 




This is toAt -fov* 5Y m ' 


#include <stdio.h> 

#include <hfcal.h> 

void display calories (float weight, float distance, float coeff) 


This todt displays the 

printf ("Weight: %3.2 f kg\n" , weight / 2.2046) ; i^-Pov-ma-tioh ih kms a^d kgs. 

printf("Distance: %3.2f km\n ", distance * 1.609344); 
printf("Calories burned : %4.2f cal\n", coeff * weight * distance); 



This -file is \ y \ the /home/ebrovm div-Cd*tov-y. 


hfcal UK.c 


The software that’s already installed on the machine needs to use this new version of the code. 
Because the applications connect to this code as a dynamic library, all you need to do is compile it into 
the /usr/local/lib directory. 

Assuming that you are already in the same directory as the hfcal_UK.c file and that you have write 
permissions on all the directories, what commands would you need to type to compile this new version 
of the library? 


If the treadmill’s main application is called /opt/apps/treadmill, what would you need to type in to run 
the program? 
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exercise so/vec/ 



t°^S ExeRclSe 
^SotutvOH 


The guys at the Head First Gym are about to ship a treadmill over to England. The embedded 
server is running Linux, and it already has the US code installed. 


The tech guys installed the library in 
/usr/local/lib. 


TWis is 


/usv/lotal/l'ik -foldcv-. 


/ 


□ 


/usr/local/lib 


Thcirc art lots o-thc^* 
ih hcv-c as well. ^ 


And this machine also has the header 
file for the hfcal library installed in 
/usr/local/include: 

TK*,S *.s -tKc /usir/lotal/rntludc (o\dcr- 


a 

_□ 

o 

_□ 

ii^oTbi 
IiiioioJ 
looiof J 

llOlQlljJ 


loot bj 
iiioioJ 
ooioun 
loionjJ 

laoiiDj 

iiioioJ 

ooioiol 

lOIOIIj) 

iooi bi 
iiioioJ 

OOIOICM 

loiomj 


common-lisp 


python2.7 


python4.2 


site—ruby 


libfluxcap.a 


libfluxcap.la 


libhfcal.so 


libmrfusion.so 


TWis is y/V)C\rC K-fdal 
libv-avy 'ms*tallcd. 



/usr/local/include 


Thc\rc a\rc lots o( othcv- 
-Pilcs ih hcv-c -too. ^ 




toot bj 
IHOloJ 
ooiouA 
loioiljj 


python2.7 


python4.2 


fluxcap.h 


\oo\ bj 

ooioiol 

loioiljj 

i^oi bi 
iiioioJ 
ooioun 
ioionjj 

\oo\ 

IHOloJ 

oo\o\A 

loioiljj 


hfcal.h 


TWis »s 


Vvftal \\tadtr Ale. 


mrfusion.h 


bwanalyze.h 


The tech guys like to install libraries using these directories because it’s a little more 
standard. The machine is all configured for use in the US, but things need to change. 
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static and dynamic libraries 


The system needs to be updated for use in the gym it is being shipped to in England. That means the 
treadmill’s display code needs to be switched from miles and pounds to kilometers and kilograms. 


#include <stdio.h> 

#include <hfcal.h> 

void display_calories(float weight, float distance, float coeff) 

{ 

printf("Weight: %3.2f kg\n ", weight / 2.2046); 
printf("Distance: %3.2f km\n n , distance * 1.609344); 
printf ("Calories burned : %4.2f cal\n", coeff * weight * distance); 

} 

hfcaLUK.c 

The software that’s already installed on the machine needs to use this new version of the code. 

Because the applications connect to this code as a dynamic library, all you need to do is compile it into 
the /usr/local/lib directory. 

Assuming that you are already in the same directory as the hfcal_UK.c file and that you have write 
permissions on all the directories, what commands would you need to type to compile this new version 
of the library? 

^ You do 灼’七 y\ccd *to sc*t 3 一 I 

/ou -to dor^pilc -the —^ acc -d --fPIC h-fdal -o K-fdal o ^ ofticm’ kedausc 1 1 

sou^c Code ho ^ object ^ilc. . . .rn a sla^da^ 

you ^ttA io the h^J ： P.r?. ..… 

objedt -Pile *to 3 sha\rcd objedt- 



If the treadmill’s main application is called /opt/apps/treadmill, what would you need to type in to run 

the program? _ ^ 4 

You do^*t r\tt& *to set L-P — LIBRARY^PATtt 

/op-t/apps/tvcadmill variable because the library is m a standard dircdWy- 


Did you spot *tha*t 七 he library headers had ms-balled m sia^dard 
div-cd*(x>ries? Tha*t you did〆 七 have bo use a 一 I when you were 

-the todt, dhd you didn't have -bo srt *thc LD^_L|BR/\Ry__P/\Ttt 
variable wKch you y/crc \rurmm 3 Code- 
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test drive 



Tesr DriVq 


Now that you’ve updated the library on the 
English treadmill, let’s try it against an American 
machine. This is one of the unaltered US 
treadmills using the original version of libhfcal.so 
library: 


yhis is _A 

WadrhiH. 






The treadmill application starts when the machine 
boots up, so after using the machine for a while the display 
shows this: 


U/QIGHT ： ))7.ii0 LBS 
DlSTOKQ ： 9.ii0 muss 
GUIORIQS BtRUQD ： 750.ii2 CUl 


The treadmill program on the US. machine is 
dynamically linking itself to the version of the libhfcal.so 
library that was compiled from the US version of the 
hf cal program. 

But what about the treadmill in England? 
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static and dynamic libraries 


The English machine has the same 
treadmill program installed, but 
on this machine you recompiled the 
libhfcal.so library from the source code 
in the hfcal_UK.c file. 


T~Kis is 
■breadmill. 




When the runner has been on the treadmill for a similar distance, 
the display looks like this: 


The — 

is displayed 

\v\ k^s. 


U/QIGHT ： S3.2 & HG 


TV>c d'is*tair>dc 
•is displayed 
m kms. 


S^DiSTOKQ ： IS.I3 m 


GAIORIQS BtRUQD ： 750.ii2 CHI 



The dalovics av-c still 
displayed *m dalovics. 


It worked. 

Even though the treadmill program was never recompiled, it was 
able to pick up the code from the new library dynamically. 

Dynamic libraries make it easier to change code at runtime. You 
can update an application without needing to recompile it. If you 
have several programs that share the same piece of code, you can 
update them all at the same time. Now that you know how to create 
dynamic libraries, you’ve become a much more powerful G developer. 
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static and dynamic 



Tonighfs talk ： Two renowned proponents of modular software 
discuss the pros and cons of static and dynamic linking. 


Static: 


Dynamic: 


Well, I think we can both agree that creating code in 
smaller modules is a good idea. 

It makes so much sense, doesn’t it? 


Absolutely. 


Yes. 


Keeps the code manageable. 


Yes. 


Nice, large programs. 

Yes. Nice BIG programs with their dependencies 
fixed. 


Large? 


What do you mean, old friend? 


Well... <laughs>•..that’s a very...but no, seriously. 


What? Lots of separate files? Joined together willy- 
nilly? \ 

But that’s.. .that’s.. .a recipe for chaosl 
You should get things right in the first place. 


That doesn’t sound like a good idea. 


I think programs should be made of lots of small 
files that link together only when the program is run. 


I’m being serious. 


I prefer the term dynamically to willy-nilly. 


It means I can change my mind later. 


But that’s not always possible. All large programs 
should use dynamic linking. 
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Static: 

All programs? 

What about the Linux kernel, hmmm? That large 
enough? And I believe that’s … 

Static linking might not be as loose and informal, 
but you know what? Static programs are simple to 
use. Single files. Want to install one? Just copy the 
executable. No need for DLL hell. 

I can’t change your mind? 

So, you’re telling me your mind is statically linked? 


(^^BUILET POINTS — 

■ Dynamic libraries are linked to 
programs at runtime. 

■ Dynamic libraries are created from 
one or more object files. 

■ On some machines, you need to 
compile them with the -f pic 
option. 

■ -f pic makes the object code 
position-independent. 

■ You can skip -f pic on many 
systems. 


Dynamic: 


I think so. 


•. .statically linked. Yeah, I know. That’s your one. 


Look, we’ll just have to agree to disagree. 


No. 


■ The -shared compiler option 
creates a dynamic library. 

■ Dynamic libraries have different 
names on different systems. 

■ Life is simpler if your dynamic 
libraries are stored in standard 
directories. 

■ Otherwise, you might need to set 

PATH and LD_LIBRARY_PATH 

variables. 
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t^ereiare no o 

Dumb Questi9ns 


Why are dynamic libraries 
so different on different operating 
systems? 

Operating systems like to optimize 
the way they load dynamic libraries, 
so they’ve each evolved different 
requirements for dynamic libraries. 

I tried to change the name of my 
library by renaming the file, but the 
compiler couldn’t find it anymore. 

Why not? 

When the compiler creates a 
dynamic library, it stores the name of the 
library inside the file. If you rename the 
file, it will then have the wrong name inside 
the file and will get confused. If you want 
to change its name, you should recompile 
the library. 

Why does Cygwin support so 
many different naming conventions for 
dynamic library files? 

Cygwin makes it easy to compile 
Unix software on a Windows machine. 
Because Cygwin creates a Unix-style 
environment, it borrows a lot of Unix 
conventions. So it prefers to give libraries 
•a extensions, even if they’re dynamic DLLs. 


Are Cygwin dynamic libraries real 
DLLs? 

Yes. But because they depend on 
the Cygwin system, you’ll need to do a 
little work before non-Cygwin code can use 
them. 

Why does the MinGW compiler 
support the same dynamic library name 
format as Cygwin? 

Because the two projects are closely 
associated and share a lot of code. The 
big difference is that MinGW programs can 
run on machines that don’t have Cygwin 
installed. 

Why doesn’t Linux just store 
library pathnames in executables? 

That way, you wouldn’t need to set 
LD 一 LIBRARY 一 PATH. 

It was a design choice. By not storing 
the pathname, it gives you a lot more 
control over which version of a library a 
program can use—which is great when 
you’re developing new libraries. 


Why doesn’t Cygwin use 
LD_LIBRARY_PATH to find 
libraries? 

Because it needs to use Windows 
DLLs. Windows DLLs are loaded using the 
PATH variable. 

Which is better? Static or 
dynamic linking? 

It depends. Static linking means 
you get a small, fast executable file that is 
easier to move from machine to machine. 
Dynamic linking means that you can 
configure the program at runtime more. 

If different programs use the same 
dynamic library, does it get loaded more 
than once? Or is it shared in memory? 

That depends on the operating 
system. Some operating systems will load 
separate copies for each process. Others 
load shared copies to save memory. 

Are dynamic libraries the best 
way of configuring an application? 

Usually, it’s simpler to use 
configuration files. But if you’re going to 
connect to some external device, you’d 
normally need separate dynamic libraries 
to act as drivers. 
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static and dynamic libraries 


Your C Toolbox 

You’ve got Chapter 8 under 
your belt，and now you’ve 
added static and dynamic 
libraries to your toolbox. For a 
complete list of tooltips in the book ， 
see Appendix ii. 



<> \ 

sta 灼 da’A 




-l<hamc> lihks 

bo a -file ih 
standard 

di\rcd*fco\rics sudh 
3s / us\r/lib. 


sdds 

^ ihe lisi 
S ^^ds\rd liblr^y 

d …比 toiries. 


The av- 
donrtmdhci 

d\rca*tcs a 
library archive 
of objedt -fil 


-X<y\3wC> adds 

a div^ 6 *t <^7 
{fi *bV>c V»st o-f 

s*ta 灼 dard mtludc 

d*irc6W»c s * 



cs. 


gdd -shared 
dor\Vc\rts 
objed 七 -files 
*m*to d>/Y\^rt\\C 
libraries. 


Library 
archives have 
hdvnCS like 

libsomc-thm^S- 


X)^Y\^rn\C 
ViW3v*CS 3vc 

Imkcd 3*t 
yuv\"b* w '€* 


ar tWwcs avc 
sta ⑽ Wf 
Vm^cA- 



Dyr\amid 
libraries have 

OY\ di-f-fcrch-t 

opc\ra*tm^ sys*tci^s. 
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^ CLab2 

OpenCV 

This lab gives you a spec that describes a 
program for you to investigate and. build, using 
the knowledge you’ve gained, over the last few 
chapters. 

This project is bigger than the ones you’ve seen so 
far. So read the whole thing before you get started, 
and. give yourself a little time. And don’t worry if 
you get stuck ； there are no new C concepts in here, 
so you can move on in the book and. come back to 
the lab later. 

It’s up to you to finish the job, but we won’t give 
you the code for the answer. 





The spec: turn your computer iwto aw intruder detector 

Imagine if your computer could keep an eye on your 
house while you’re out and tell you who’s been prowling 
around. Well, using its default webcam and the cleverness 
of OfienCV，it can! 

Here’s what you’re going to create. 


The intruder detector 

Your computer will constantly survey its surroundings using its 
webcam. When it detects movement, it will write the current 
webcam image to a file. And if you store this file on a network 
drive or use a file synchronization service such as Dropbox, 
you’ll have instant evidence of any intruders. 



Wheh the 
spo*ts rMovcr^Ch' (: 
through its webdarh... 


.rt Ns/Vltcs SCCS "to 

Wc. 










OpewCY 

OpenGV is an open source computer vision library. It allows you 
to take input from your computer camera, process it, and analyze 
real-time image data and make decisions based on what your 
computer sees. What’s more, you can do all of this using G code. 

OpenGV is available on Window, Linux, and Mac platforms. 

You can find the OpenGV wiki here: 

http:/ / opencv. willowgamge. com/wiki/FullOpen C VWiki 


Ihstallmg OpenCV 

You can install OpenGV on Windows, Linux, or Mac. The 
install guide is here, and includes links to the latest stable releases: 


http:/ / opencv. willowgamge. com/wiki/1nsta ll Guide 


Once you’ve installed OpenGy you should see a folder on your 
computer labeled samples. It’s worth taking a look at these. There 
are also links to tutorials on the OpenGV wiki. You’ll need to 
investigate OpenGV in order to complete this lab. 

If you want to get deep into OpenG\^ we recommend the book 
Learning OpenCVby Gary Bradski and Adrian Kaehler (O’Reilly). 


\Mt -fouy>d book 

0^tr\CM 

•mspiva 七 10 灼 al. 









What your code should do 

Your G code should do the following. 


Take input from your computer camera 

You need to work with real-time data that comes in from your 
computer camera, so the first thing you need to do is capture that 
data. There’s an OpenGV function that will help you with this 
called cvCreateCameraCapture (0) . It returns a pointer to a 
CvCapture struct. This pointer is your hotline to the webcam 
device, and you’ll use it to grab images. 

Remember to check for errors in case your computer can’t find a 
camera. If you can’t contact the webcam, you’ll receive a NULL 
pointer from cvCreateCameraCapture (0). 

^rab an image from the webcam 

You can read the latest image from the webcam using the 
cvQueryFrame () function. It takes the CvCapture pointer as 
a parameter. The cvQueryFrame () function returns a pointer to 
the latest image, so your code will probably start with something a 
little like this: 



Image file 


CvCapture* webcam = cvCreateCameraCapture(0); 
if (!webcam) ^ - TK'is med ⑽ w Could 灼 ’ 七 -f md v/ebdam. 

/* Exit with an error */ 

while (1) { Loop Wvcv-. 

Read By\ i 州 工 pi Image* image = cvQueryFrame (webcam); 

-fvom 七 he 

if (image) { 

- ^ |-f you vedd yoi/ll *to pvodcss i*t 


If you decide that there’s a thief in the image, you can save the 

image to a file with: r 丄 l ， C i- The imay you v*cad 

g The -P.le J Jebda- 

cvSavelmage (’ ’somefile•jpg", image, 0); 



Uhlcss you waht 
this -flag -to O. 


a 

set 





Petect aw intruder 

Now you come to the really clever part of the code. How do you 
decide if there’s an intruder in the frame? 

One way is to check for movement in the image. OpenGV has 
functions to create a Farneback optical flow. An optical flow 
compares two images and tells you how much movement there’s 
been at each pixel. 

This part, you’ll need to research yourself. You’ll probably 
want to use the cvCalcOpticalFlowFarneback () to 
compare two consecutive images from the webcam and create 
the optical flow. From that, you’ll need to write some code that 
measures the amount of movement between the two frames. 

If the movement’s above a threshold level, you’ll know that 
something large is moving in front of the webcam. 

Make a clean getaway 

When you start the program, you don’t want the camera to record 
you walking away, so you might want to add a delay to give you 
time to leave the room. 


Maybe if I move 
reeeaaaally slooooowly, 
it won't spot me... 


O 


o 



Optional: show the current webcam output 

During our tests here at the lab, we found it useful to check on 
the current images the program is seeing. To do this, we opened a 
window and displayed the current webcam output. 

You can easily create a window in OpenGV with: 

cvNamedWindow("Thief ", 1); 

To display the current image in the window, use this: 

cvShowImage (’ ’Thief, image); 


The finished product 

You’ll know your OpenGV project is complete when your 
computer is able to automatically take pictures of people 
trying to sneak up on it. 



Wky stop tkere? WeVe sure you kave all 
kinds oi exciting ideas ior wkat you coulct 
cto witk OpenCV. Drop us a line at Head 
First LaLs and let us know kow OpenCV is 
working out ior you. 
















processes and system calls 


If s time to become a C ninja... 

The final part of the book covers advanced topics. 

As you’re going to be digging into some of the more 
advanced functions in G, you’ll need to make sure 
that you have all of these features available on your 
computer. If you’re using Linux or Mac, you’ll be 
fine, but if you’re using Windows, you need to have 
Gygwin installed. 

Once you’re ready, turn the page and enter the gate … 
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^ Breaking boundaries ♦ 



It’s time to think outside the box. 

You’ve already seen that you can build complex applications by connecting small tools 
together on the command line. But what if you want to use other programs from inside 
your own code? In this chapter, you’ll learn how to use system services to create and 
control processes. That will give your programs access to email, the Web, and any other 
tool you J ve got installed. By the end of the chapter, you’ll have the power to go beyond C. 


this is a new chapter 


systemQ 


System calls are your hotline to the OS 


G programs rely on the operating system for pretty much 
everything. They make system calls if they want to talk 
to the hardware. System calls are just functions that live 
inside the operating system’s kernel. Most of the code in 
the G Standard Library depends on them. Whenever you 
call printf () to display something on the command 
line, somewhere at the back of things, a system call will be 
made to the operating system to send the string of text to 
the screen. 




Let’s look at an example of a system call. We’ll begin with 
one called (appropriately) system (). 

system () takes a single string parameter and executes it 
as if you had typed it on the command line: 

system("dir D: n ) ; ^sr^TWis v/ill pvmt ou*t o( P* dv-We’ 

system("gedit") ； V-This will U 心 ediU o, LW. 

system ("say 'End of line 1 ") This v/ill read h> you oy\ the Mad. 


The system () function is an easy way of running other 
programs from your code — particularly if you’re creating 
a quick prototype and you’d sooner call external programs 
rather than write lots and lots of G code. 
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Code Magnets 


This is a program that writes timestamped text to the end of a logfile. It would have 
been perfectly possible to write this entire program in C, but the programmer has 
used a call to system () as a quick way of dealing with the file handling. 



See if you can complete the code that creates the operating system command 
string that displays the text comment, followed by the timestamp. 


#include <stdio.h> 
#include <stdlib.h> 
#include <time.h> 


char^ 



TVis v-ctums a sbr\^ 

乙 uvrcrrb date and 州 c. 


time_t t; 
time (Set ); 

return asetime(localtime (&t)); 


/* Master Control Program utility. 

Records guard patrol check-ins. */ 
int main() 

{ 

char comment[80]; 
char cmd[120]; 



system(cmd); 
return 0; 


I sprintf j 


「 comment j 



j 80] j stdin j J cmd | 
[^ ow( H [ scanf~| ptd^tj 
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magnets moved 


Code Magnets Solution 


This is a program that writes timestamped text to the end of a logfile. It would have 
been perfectly possible to write this entire program in C, but the programmer has 
used a call to system () as a quick way of dealing with the file handling. 

You were to complete the code that creates the operating system command string 
that displays the text comment, followed by the timestamp. 

#include <stdio.h> 

^include <stdlib.h> 

#include <time.h> 


char* now() 

{ 

time_t t; 
time (&t); 

return asctime(localtime (&t)) 


* Master Control Program utility. 
Records guard patrol check-ins. 


V 


int main() 

{ 

char comment[80]; 
char cmd[120]; 

Wsihg -pgcts -Pov- 

uhs-tvud-tuvcd 
text 

w'»H 卜七 * ^ sprintf 

i\\t cMaracitrs *to . L 

d s*br’m<V 




I 七 Y\ttds bo s-tov-c 

3V"V"sy* 


Thc\rc is \roorh 
-Po\r ohly dO 

|4 


T\\t data will 
-from ■biic S*ta^dav-d 
keyboav-d- 




This is 七 he 

七 empla 七 e. 



^ 一 - TV -Pov-ma-t-bcd s-bv-'mj will be 
sbortd m dmd a^rvay. 


The donr\nr\d)r)d V/lll 


"the donr»nr»c^-t "to B 


apper 

-rile- 


TWis \runs {\\t 一 
七 he s-tv-'mj. 


「 comment j 


system(cmd); 
return 0; 




丁 he dommchi will 
appeav* -fivst. 


The appears seto^d. 
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Tqst DriVq 


Let’s compile the program and then watch it in action: 


This v/i|| Compile 
"the pv-ojv-am. 

This vuy>s 、 X 

program. 

RuKmmg _七 a 
^ttoy\A "tirwc 


I File Edit Window Help Who'sYourUser 


> gcc guard 一 log•c -o guard—log 

> ./guard_log _ 

Checked in Crom - a compound interest program. 

> ./guard 一 log 

Blue Leader reports breach in jet walls. 

> 



This is a 


Now, when you look in the same directory as the program, 
there’s a new file that’s been created called reports.log: 


These av-c 七 he 

turwcstamps. 




Checked in Crom 一 a compound interest program. 
Thu Oct 29 11:25:53 2015 


Blue Leader reports breach in jet walls. 
Thu Oct 29 11:26:06 2015 





The program worked. It read a comment from the command 
line and called the echo command to add the comment to 
the end of the file. 


reports.log 


This is 七 he 


vcfovts.lo^ 


七 he fvo^vam 

dveated- 


Even though you could have written the whole program in G, 
by using system (), you simplified the program and got it 
working with very little work. 


D 


therejcire no 

)umb Qu 


Questions 


Does the system () function get compiled into my 
program? 


No. The system () function—like all system calls— 
doesn’t live in your program. It lives in the main operating system. 


So, when I make a system call, I’m making a call to 
some external piece of code, like a library? 

Kind of. But the details depend on the operating system. 

On some operating systems, the code for a system call lives inside 
the kernel of the operating system. On other operating systems, it 
might simply be stored in some dynamic library. 
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yikes 


Thcw someone busted iwto the system 


There’s a downside to the system () function. It’s 
quick and easy to use, but it’s also kinda sloppy. Before 
getting into the problems with system (), let’s see 
what it takes to break the program. 

The code worked by stitching together a string 
containing a command, like this: 



<comment> | 

u 

<timestamp> | 



But what if someone entered a comment like this? 



By injecting some command-line code into the text, 
you can make the program run whatever code you 


like: 


The usev- use 
the p\rogv-olrw -to 一 ^ 
V*Uh 

she likes oh the 


File Edit Window Help Yikes 



^\Tliis is a 
listmg o( 

the vwt 
div-cd-fcovy. 


Is this a big problem? If a user can run guard—log, 
she can just as easily run some other program. But 
what if your code has been called from a web server? 
Or if it’s processing data from a file? 
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Security's wot the only problem 


This example injects a piece of code to list the contents of the root 
directory，but it could have deletedfiles or launched a virus. But you 
shouldn’t just worry about security. 


o 

o 

o 


What if the comments contain apostrophes? 

That might break the quotes in the command. 

What if the PATH variable causes the system() function 
to call the wrong program? 

What if the program were calling needs to have a specific 
set of environment variables set up first? 


The system () function is easy to use, but most of the time, you’re 
going to need something more structured — some way of calling a 
specific program, with a set of command-line arguments and maybe 
even some environment variables. 



Gee| Bits 


What's the kernel? 

On most machines, system calls are functions that live inside the kernel of the operating system. But 
what is the kernel? You never actually see the kernel on the screen, but it’s always there, controlling your 
computer. The kernel is the most important program on your computer, and it’s in charge of three things: 

Processes 

No program can run on the system without the kernel loading it into memory. The kernel creates 
processes and makes sure they get the resources they need. The kernel also watches for processes that 
become too greedy or crash. 

Memory 

Your machine has a limited supply of memory, so the kernel has to carefully ration the amount of memory 
each process can take. The kernel can increase the virtual memory size by quietly loading and unloading 
sections of memory to disk. 

Hardware 

The kernel uses device drivers to talk to the equipment that’s plugged into the computer. Your program 
can use the keyboard and the screen and the graphics processor without knowing too much about them, 
because the kernel talks to them on your behalf. 

System calls are the functions that your program uses to talk to the kernel. 
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The execH fuwetiows give you more control 

When you call the system () function, the operating 
system has to interpret the command string and decide 
which programs to run and how to run them. And that’s 
where the problem is: the operating system needs to interpret 
the string, and you’ve already seen how easy it is to get that 
wrong. So, the solution is to remove the ambiguity and 
tell the operating system precisely which program you want 
to run. That’s what the exec () functions are for. 


execO functions replace the current process 

A process is just a program running in memory. If you 
type taskmgr on Windows or ps -ef on most other 
machines, you’ll see the processes running on your system. 
The operating system tracks each process with a number 
called the process identifier (PID). 

The exec () functions replace the current process by 

running some other program. You can say which command¬ 
line arguments or environment variables to use, and when the 
new program starts it will have exactly the same PID as the 
old one. It’s like a relay race, where your program hands 
over its process to the new program. 


A process 


is a program 


running in memory. 
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There are many execO fuwetiows 


Over time, programmers have created several different versions 
of exec () . Each version has a slightly different name and its 
own set of parameters. Even though there are lots of versions, 
there are really just two groups of exec () functions: the list 
functions and the array functions. 


Tke execO iunctions 
are in unistct.lt. 


The list functions: execKl execlpd execleO 


The list functions accept command-line arguments as a list of 
parameters, like this: 


o 

o 

o 


The program. 

This might be the full pathname of the program — execl () / 
execle () — or just a command name to search for — exeelp () 
but the first parameter tells the exec () function what program it 
will run. 

The command-line arguments. 

You need to list one by one the command-line arguments you want 
to use. Remember: the first command-line argument is always the 
name of the program. That means the first two parameters passed 
to a list version of exec () should always be the same string. 

NULL. 

That’s right. After the last command-line argument, you need a 
NULL. This tells the function that there are no more arguments. 



Spaces in 
command line 
arguments 
can confuse 
MinGW. 

If you pass two arguments “I 
like”and “turtles，”MinGW 
programs might send three 
arguments: “I，” “like，”and 
“turtles.” 



Environment variables (maybe). 

If you call an exec () function whose name ends with . . . e (), you can 
also pass an array of environment variables. This is just an array of strings 
like n P0WER=4 n , n SPEED=17 n , n PORT=OPEN n , …. 


— a L|ST o( 


These av-c 七 av-^umcir>*b. 


execl ("/home/flynn/clu" , ^"/home/flynn/clu" r "paranoids" , "contract" , NULL) 

Tk 厂 ^LP 二 a LIST d 扣 5 _伙长 t W 〜 s ^ uld 

y + o,-the PATH. These e,d Ihe lisi 

siiould be u 广 wi 七 h NlAL^L^ 

as exeelp (’ 'clu’"clu n , "paranoids" , "contract" , NULL) 

■tiic -f iv-st 


Ti^csc av-c av^umcirrts. 


execle ("/home/flynn/clu" , ^'/home/flynn/clu" , "paranoids" , "contract ", 


A 


― 3 L|ST o-f 

+ B^VIROmBhlT variables. 


,env vars) 

个 - 

cywjavs IS a 灼 avv-ay o( s-tv-'m^s 
cywivovwcvrt vav-iablcs. 
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array functions 


The array fuwetiows: exeevO, exeevpO, exccvcO 

If you already have your command-line arguments stored in an 
array, you might find these two versions easier to use: 


/ 二 3\r\r3y o\r — 
VICTOR o-f av*^urwCh*ts. 


exeev (" /home/flynn/clu" , my_args); 

^>TV>C av-^umc^ts r\ttA *to be s-toved 

VICTOR o*P exeevp ( n clu n , my_args) ; m ^ ^/- a M s 七， a 代 a Y. 

+ scav-dh or\ 如 PATH. _ 

The only difference between these two functions is that 
exeevp will search for the program using the PATH variable. 


How to remember the execO functions 

You can figure out which exec () function you need by 
constructing the name. Each exec () function can be followed 
by one or two characters that must be 1, v, p, or e. The 
characters tell you which feature you want to use. So, for the 
execle () function: 


execle 


exec 


+ I + e = LIST ol arguments + an E^VIRO^MEMT 


The 1 and v characters always come before p and e. 
and the p and e characters are optional. 


AH -Puhdtio^s 

bejih v/rth 


Take a lis-t o-P avaurwe^'ts- 

V 


Uses 

Character 

List of args 

1 

Array/vector of args 

V 

Search the path 

P 

Environment vars 

e 


Scav-dh 
-Pov -the 

., P\roa\ranr» OY\ ^ 

Take a v^U/a^ay ^ 咖 

Or 


>U doy /七 
have -fco 
•mdude p ^ 
oy c - 


Use av-vay 

of erwivo 灼 me 灼 *t 

s*bri 呼 . 
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processes and system calls 


Passing ewvirowmcwt variables 


Every process has a set of environment 
variables. These are the values you see when 
you type set or env on the command 
line, and they usually tell the process 
useful information, such as the location 
of the home directory or where to find 
the commands. G programs can read 
environment variables with the getenv () 
system call. You can see getenv () being 
used in the diner_inf o program on the 
right. 

If you want to run a program using 
command-line arguments and environment 
variables, you can do it like this: 


sei o-f 

Chviv-ohmch-t 
variables as av\ avv-ay 
poihtcv-s. 


char *my env[] 




#include <stdio.h> 

#include <stdlib.h> 

int main(int arge, char *argv[]) 

{ 

printf("Diners : %s\n n , argv[1]); 
printf ("Juice : %s\n n , getenv (’ ▼JUICE’ 1 )); 
return 0; 


r 


m s*tdl»b K lc*ts you 
vedd c^vivor>rwcr\*t vaviablcs. 



execle("diner info' 


emetic passes a l'is*t o( av-^umcy>*U 扣 d 


^.acM vav-iablc "m 

JUICE=peach and apple 
1 , "diner info ", "4" 


The last item ih the 

^ust be h/ULL. 

NULL}; 


diner info.c 


eywivo 灼 merrt. 


NULL, my_env); 

f 

你 y 一 ChV doh-brns -the Chviv-ohrwCht 


The execle () function will set the command-line 
arguments and environment variables and then replace the 
current process with diner_inf o. 


I File Edit Window Help MoreOJ 


> ./my_exec_j>rogram 
Diners : 4 

Juice : peach and apple 

> 一 


Put what if there's a problem? 

If there’s a problem calling the program, the existing process 
will keep running. That’s useful, because it means that if you 
can’t start that second process, you’ll be able to recover from 
the error and give the user more information on what went 
wrong. And luckily, the G Standard Library provides some 
built-in code to help you with that. 



If you’re 
passing an 
environment 
on Cygwin ， 
be sure to 


include a PATH variable. 


On Cygwin, the path 
variable is needed when 
programs are loaded. So, if 
you’re passing environment 
variables on Cygwin, be sure 
to include PATH=/usr/bin. 
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errno 


Most system calls go wrong m the same way 


Because system calls depend on something outside your 
program, they might go wrong in some way that you can’t 
control. To deal with this problem, most system calls go 
wrong in the same way. 

Take the execle () call, for example. It’s really easy to 
see when an exec () call goes wrong. If an exec () call 
is successful, the current program stops running. So, if the 
program runs anything after the call to exec (), there must 
have been a problem: 


Guaranteed K 
Standard of 、 
X Failure / 



4 n , NULL, my env); 


l*f c^cdlcO wovked ； execle ("diner_info f, , "diner_info 

七 his o( Code — ■ ， — 

would “ 一 - /^puts("Dude - the diner—info code must be busted"); 


titter \rur>. 


But just telling if a system call worked is not enough. You 
normally want to know why a system call failed. That’s w 
most system calls follow the golden rules of failure. 

The errno variable is a global variable that’s defined in 
errno.h, along with a whole bunch of standard error values, 
like: 



EPERM=1 


Operation not permitted 


ENOENT=S No such file or directory 

ESRCH=3 No such process 

I JL 

I his value is 、 

⑽七 available EMULLET=81 Bad haircut 

a " 〒七加 s . --- -^^- - ' 


OY\ 


"The ^o\dcv\ Rules 
Failure 

* Tidy up as mudh as you 

* Set the cv-v-ho variable h> 

C\r\ro\r value* 

來 RrtuVh —厂 


Now you could check the value of errno against each of 
these values, or you could look up a standard piece of error 
text using a function in string.h called strerror () : 

puts (strerror (errno) ) ; ( — s-tv-cv-vov-0 doiavc\r*b cv-v-ov 

m*to 3 message. 


So, if the system can’t find the program you are running 
and it sets the errno variable to ENOENT, the above code 
will display this message: 
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No such file or directory 







processes and system calls 




Different machines have different commands to tell you about their network configuration. On 
Linux and Mac machines, there’s the /sbin/ifconfig program, and on Windows there’s a 
command called ipconfig that’s stored somewhere on the command path. 

This program tries to run the /sbin/ifconf ig program and, if that fails, it will try the 
ipconfig command. There’s no need to pass arguments to either command. Think carefully. 
What type of exec () comnnands will you need? 


#include <stdio.h> 


^ 七 hcadcvs vyill you 


This v/ill need ■fco nm / sbm/i-fig. 
l/Vha-t should v/c -test -Pov-? 


This v/ill y\ttA -fco v-ur> 
七 he ipdoh-fig 

3 的 d i-f i-t (b\\s. 


int main() 

{ 

if (. 

if (exeelp( ) 

fprintf(stderr, "Cannot run ipconfig : %s", 

return 1; 个 

} do you *tiVmk ^ocs iic\rc? 

return 0; 
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exercise solved 




RctSe 

IvtlOH 


Different machines have different commands to tell you about their network configuration. On 
Linux and Mac machines, there’s the /sbin/ifconfig program, and on Windows there’s a 
command called ipconfig that’s stored somewhere on the command path. 

This program tries to run the /sbin/ifconf ig program and, if that fails, it will try the 
ipconfig command. There’s no need to pass arguments to either command. Think carefully. 
What type of exec () commands will you need? 


#include <stdio.h> 

<txr.y>oM> .^y° u .^ cd . ^ is . ^ iht 伙作。象 iable . 

井 亡二 T hiS .Y!" 上七 .产 d ， S P ,a Y cm>lrs wi 仏 s ^\nro\rO- 


int main () 
{ 


Wsc exedO because you have 七 he 
paih bo -the p\rog\rarw -Pile. 

0 V 

if (.… 奸 ? 逆 rrrrr ..rJ 
if (exeelp( •. . w ».p^oh-fig ^ NULL) =7 

fprintf(stderr, "Cannot run ipconfig : %s 

let us I'md , 

iPdo^ig return 1; U value --I 

} 伽如 domma ^ d la,lcd . 

tiic patt- return 0; 


|-f c^CdlO \rc*tuvr\s -I, i*t -failed ； so 
y/e should fvobably look -fov iporvfi 》 



丁 k stvlv*\ro\r0 -Puhd-tioh 
will display a^y pvoblcr^s. 
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processes and system calls 



Dumb Quest! 


9ns 


Isn’t system () just easier to use than exec () ? 


Yes. But because the operating system needs to interpret the 
string you pass to system () ， it can be a bit buggy. Particularly 
if you create the command string dynamically. 


Why are there so many exec () functions? 


^/\^ 二 Over time, people wanted to create processes in different 
ways. The different versions of exec () were created for more 
flexibility. 


Do I always have to check the return value of a system 
call? Doesn’t it make the program really long? 

If you make system calls and don’t check for errors, your 
code will be shorter. But it will probably also have more bugs. It is 
better to think about errors when you first write code. It will make it 
much easier to catch bugs later on. 

If I call an exec () function, can I do anything 
afterward? 

A: No . Ifthe exec () function is successful, it will change the 
process so that it runs the new program instead of your program. 
That means the program containing the exec () call will stop as 
soon as it runs the exec () function. 


BULLET POINTS —— 

■ System calls are functions that live in 
the operating system. 


■ The exec () system calls let you 
run programs with more control. 


■ When you make a system call, 
you are calling code outside your 
program. 

■ system () is a system call to run a 
command string. 

■ system () is easy to use, but it 
can cause bugs. 


■ There are several versions of the 
exec () system call. 

■ System calls usually, but not always, 
return -1 if there’s a problem. 

■ They will also set the errno 
variable to an error number. 
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mixed messages 



Mixed 

Messages 


The guys over at Starbuzz have come up with a new order-generation program that 
they call coffee: 

#include <stdio.h> 

#include <stdlib.h> 

int main(int argc, char *argv[]) 

{ 

char = getenv("EXTRA"); 
if (!w) 

w = getenv("FOOD"); 
if (!w) 

w = argv[argc - 1]; 
char *c = getenv("EXTRA"); 
if (!c) 

c = argv[argc - 1]; 
printf("%s with %s\n n , c, w); 
return 0; 


To try it out, they’ve created this test program. Can you match up these code fragments to the output they produce? 


#include <string.h> 

#include <stdio.h> 

#include <errno.h> 

int main(int argc, char *argv[]){ 


广 Ca^dida-tc code ^ocs 


fprintf(stderr,"Can't create order : %s\n ", strerror(errno)); 
return 1; 

} 

return 0; 
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processes and system calls 


Candidates: 


Possible output 

t 


OhC 


char *my—env[] = { n FOOD=coffee ”， NULL}; 

if(execle("./coffee ", "./coffee ", "donuts", NULL, my—env) == -1){ 

fprintf(stderr,’’Can’t run process 0: %s\n n , strerror(errno)); coffee with donuts 

return 1; 


char *my__env [ ] = { n FOOD=donuts” ， NULL}; 

if(execle("./coffee ", M ./coffee", "cream", NULL, my_env) == -1){ 

fprintf(stderr,"Can't run process 0: %s\n n , strerror(errno)); cream with donuts 

return 1; 

} 

if(execl("./coffee", "coffee", NULL) == -1){ 

fprintf (stderr,’▼ Can' t run process 0: %s\n n , strerror (errno)); 

donuts with coffee 

return 1; 


char *my_env[] = { n FOOD=donuts ”， NULL}; 

if(execle( n ./coffee", "coffee", NULL, my—env) == -1){ 

fprintf(stderr,"Can't run process 0: %s\n n , strerror(errno)); 
return 1; 


coffee with coffee 
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messages unmixed 



Mixed 

Messages 

Solution 


The guys over at Starbuzz have come up with a new order-generation program that 
they call coffee: 

#include <stdio.h> 

#include <stdlib.h> 

int main(int argc, char *argv[]) 

{ 

char = getenv("EXTRA"); 
if (!w) 

w = getenv("FOOD"); 
if (!w) 

w = argv[argc - 1]; 
char *c = getenv("EXTRA"); 
if (!c) 

c = argv[argc - 1]; 
printf("%s with %s\n n , c, w); 
return 0; 


To try it out, they’ve created this test program. Can you match up these code fragments to the output they produce? 


#include <string.h> 

#include <stdio.h> 

#include <errno.h> 

int main(int argc, char *argv[]){ 


广 Ca^dida-tc code ^ocs 


fprintf(stderr,"Can't create order : %s\n ", strerror(errno)); 
return 1; 

} 

return 0; 
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processes and system calls 


Candidates: 


Possible output: 


char *my_env[] = { n FOOD=coffee ”， NULL}; 

if(execle("./coffee", "./coffee ”， "donuts '、 NULL, my_env) == -1){ 
fprintf(stderr,"Can't run process 0: %s\n n , strerror(errno)); 
return 1; 


coffee with donuts 


char *my 一 env[] = { n FOOD=donuts ”， NULL}; 

if(execle("./coffee", M ./coffee", "cream", NULL, my 一 env) == -1){ 
fprintf(stderr,"Can't run process 0: %s\n n , strerror(errno)); 
return 1; 


cream with donuts 


if(execl("./coffee", "coffee", NULL) == -1){ 

fprintf(stderr,"Can't run process 0: %s\n n , strerror(errno)); 
return 1; 


donuts with coffee 


char *my 一 env[] = { n FOOD=donuts ”， NULL}; 

if(execle( n ./coffee", "coffee", NULL, my— env) == -1){ 

fprintf(stderr,"Can't run process 0: %s\n n , strerror(errno)); 
return 1; 

} 


coffee with coffee 
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rss gossip 


Read the news with RSS 

RSS feeds are a common way for websites to publish 
their latest news stories. Each RSS feed is just an 
XML file containing a summary of stories and links. 
Of course, it’s possible to write a G program that will 
read RSS files straight off the Web, but it involves 
a few programming ideas that you haven’t seen yet. 
But that’s not a problem if you can find another 
program that will handle the RSS processing for you. 









Download RSS Gossip from 

h ttps://github. com/dogriffi ths/rssgossip/zipball/mas ter. 

Also, if you don’t have Python installed, you can get it here: 
h ttp://www. python, org/. 


I want all the latest 
stories on Pajama Death. 


RSS Gossip is a small Python script that can search 
RSS feeds for stories containing a piece of text. To run 
the script, you will need Python installed. Once you 
have Python and rssgossip.py, you can search for 
stories like this: 


Tiiis is m ^ 

Ur\i% cr\\/i\ro 灼 me 灼 *t. 

Y^u y\ttA -to 

vilviablc ^Oh-tolihih^ . 〜 ^ 
the ddd\ress o-p 

RSS kd. 




File Edit Window Help ReadAIIAboutlt 



v-ss^oss'if s£.\rip*t 
s-tv'mj. 


> export RSS_FEED=http : //www. enn. com/rss/celebs . xml 

> python rssgossip.py 'pajama death' ^ 

Pajama Death launch own range of kitchen appliances. 
Lead singer of Pajama Death has new love interest. 

"I never ate the bat" says Pajama Death’s Hancock. 


TWis 3 
veal -feed- 
You should 
v-cflate i*t 
ov\t you 
-f'md or^lrnc- 




416 Chapter 9 



Ooh, I just had a great idea. 
Why not write a program that 
can search a lot of RSS feeds 
all at once! Can you do that? 
















processes and system calls 



Ex^f(ciSe 


The editor wants a program on his machine that can search a lot of RSS feeds all at the 
same time. You could do that if you ran the rssgossip.py several times for different RSS feeds. 
Fortunately, the out-of-work actors have made a start on the program for you. Trouble is, 
they’re having problems creating the call to exec () the rssgossip.py script. Think carefully 
about what you need to do to run the script, and then complete the newshound code. 


To save spate, tWis listrnj dotsr!i 


sV^ova 


pate, this 


I'mcs. 


int main (int arge, char *argv[] ) a\rc RSS -feeds -the edi-fcov* wa^ts 

l y ou 叫吵七 waht to choose youv- owh). 

{ ^ 

char ^feeds[] = {"http :/ /www.enn.com/rss/celebs.xml ", 

"http :// www.rollingstone.com/rock.xml n , 

"http :// eonline.com/gossip.xml n }; 

int times = 3; ^ 一 _ ^|| pass i\\t scav-dli tcv-ms m as av\ 

char ^phrase = argv[1]; 

int i ; 


《 Loop -thv-oujli cadh of -the -feeds. 

for (i =0; i < times; i++) { 


char var[255]; 

sprintf (var, n RSS_FEED=%s f, , feeds [ i ]); 

char ^vars [ ] = {var, NULL} ; / 0 的 the cdi*tov*s Alad’ Python is ms'bdllcd hcv*c- 


if 


(’▼ /usr/bin/python' 


/ us r/bin/python, 

)==- 1 ) { 

fprintf (stderr7\、 n Can ▼ t run script : %s\n n , strerror (errno)) 

return 1; y ou ^ i hS 饮七七 he olhev 

-fco the (uh^tioh hcv*c- 


return 0; 


newshound.c 


And for extra bonus points... 

What will the program do when it runs? 
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newshound hounded 



The editor wants a program on his machine that can search a lot of RSS feeds all at the 
same time. You could do that if you ran the rssgossip.py several times for different RSS feeds. 
Fortunately, the out-of-work actors have made a start on the program for you. Trouble is, 
they’re having problems creating the call to exec () the rssgossip.py script. You were to think 
carefully about what you need to do to run the script, and then complete the newshound code. 


YouVc usmg 
a LIST _ 

a\r<\s 3 灼 d 3 灼 


av-js aY\d 
£ 刚 _- 
膚 T, s 。 

rt’s 



char *feeds[] = {"http :/ /www.cnn.com/rss/celebs.xml ", 

http :// www.rollingstone.com/rock.xml ", 
http :// eonline.com/gossip.xml n }; 

int times = 3; 
char ^phrase = argv[1]; 
int i ; 

for (i = 0; i < times; i++) { 

char var[255]; 

sprintf(var, "RSS FEED=%s n , feeds[i]); 
char *vars[] = {var, NULL}; 

if ( ("/usr/bin/python " ， " / usr/bin/python 

u /v?. s 3?. s .^.p ： p.y w ? ^ ) == -i) { 

fprintf(stderrA "Can't run\script : %s\n",] strerror(errno)) 


return 


This is the 
o( the 

Pythoh sd\ript. 


return 0; 


TK'»s is 

as d 
Ime 


Pass 七 he 

C 灼 V_\ro 灼 mcivt 

ds by \ c/.tva 
pa\ramcic\r. 


newshound.c 


But what will the program do when you run it? 
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Tqst DriVq 


When you compile and run the program, it looks like it works: 


I File Edit Window Help ReadAIIAboutlt | 


> ./newshound 'pajama death' 

Pajama Death ex-drummer tells all. 

New Pajama Death album due next month. 


The newshound program has the rssgossip.py script using data 
from the array of RSS feeds. 


Worked!? Worked?!? It didn’t work! What about 
the announcement of the surprise concert? That 
was on every other news site! I coulda sent my 
photographers down there. As it is, I was beaten 
to the story by everyone else in town! 


Actually there is a problem. 

Although the newshound program managed 
to run the rssgossip.py script, it looks like it didn’t 
manage to run the script for all of the feeds. In fact, 
the only news it displayed came from the first 
feed on the list. That meant the other news 
stories matching the search terms were missed. 






Look at the code of the newshound program again and think about how it works. 
Why do you think it failed to run the rssgossip.py script for any of the other 
newsfeeds? 
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fork() 


execH is the end of the line for your program 


The exec () functions replace the current 
function by running a new program. But what 
happens to the original program? It terminates, 
and it terminates immediately. That’s why the 
program only ran the rssgossip.py script for the 
first newsfeed. After it had called execle () the 
first time, the news hound program terminated. 


TiiC loof y/ill v-ur\ or\ly oy\tt> 


for (i = 0; 


< times; i++) 


Ov\Ct r\Cwsiiou^di pvoyam ha 的 ds ovcv 
pvodcss *bo vss^ossip.fY 
Y\t^s\\0\AY\d 




if (execle (’▼/usr/bin/python" , n / usr/bin/python ", 

Ot\tt is n . / rssgossip.py n , phrase, NULL, vars) == -1 ) { 

tsWtAi the whole ... 


pv-ogvarw ^ui*ts- 


But if you want to start another process and keep 
your original process running, how do you do it? 

fork!) will clone your process 

You’re going to get around this problem by using 
a system call named fork (). 

fork () makes a complete copy of the current 
process. The brand-new copy will be running 
the same program, on the same line number. It 
will have exactly the same variables that contain 
exactly the same values. The only difference is 
that the copy process will have a different process 
identifier from the original. 

The original process is called the parent 
process, and the newly created copy is called 

the child process. 

But how can cloning the current process fix the 
problems with exec () ? Let’s see. 



Unlike Linux 
and the Mac, 
Windows 
doesn’t support 
fork () natively. 

To use fork () on a Windows 


machine, you should first install 
Cygwin. 


The -fovkO system dall W\W 

dlor>e -the duv-\rcy>*t fv-odcss. 

丁 he Olri^ihdl 
yy-oCcss is 
乙 ailed the 

pairchi pvo^ss. 



Tiic fvodcss 
is ddlled 
乙 Wild fv-odcss. 
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processes and system calls 


Rimwiwg a child process with fork() + execO 


The trick is to only call an exec () function on a child 
process. That way, your original parent process will be able 
to continue running. Let’s look at the process step by step. 


1. Make a copy 

Begin by making a copy of your current process by calling 
the fork () system call. 

The processes need some way of telling which of them is 
the parent process and which is the child, so the fork () 
function returns 0 to the child process, and it will return a 
nonzero value to the parent process. 



Z. If youYc the child process, call execO 


At this point, you have two identical processes running, 
both of them using identical code. But the child process 
(the one that received a 0 from the fork () call) now needs 
to replace itself by calling exec () : 


The c\\\\A pvotcss dalls 



Now you have two separate processes: the child process 
is running the rssgossip.py script, and the original parent 
process is free to continue doing something else. 
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code magnets 


Code Magnets 



It’s time to update the newshound program. The code needs to run the 
rssgoss/p.py script in a separate process for each of the RSS feeds. The code 
is reduced, so you only have to worry about the main loop. Be careful to 
check for errors, and don’t get the parent and child processes mixed! 


Put you\r 
•m *tW»S 


for (i = 0; i < times; i++) { 

char var[255]; 
sprintf(var f "RSS FEED=%s n , 






char *vars[ 


var, NULL} 


feeds[i]); 
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processes and system calls 



fork () will actually return an integer value that is 0 for 
the child process and positive for the parent process. 
The parent process will receive the process identifier of 
the child process. 

But what is pid_t? Different operating systems use 
different kinds of integers to store process IDs: some 
might use shorts and some might use ints. So pid t 
is always set to the type that the operating system uses. 
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magnets unmuddled 


Code Magnets Solution 


It’s time to update the newshound program. The code needs to run the 
rssgoss/p.py script in a separate process for each of the RSS feeds. The code 
is reduced, so you only had to worry about the main loop. Be careful to 
check for errors, and don’t get the parent and child processes mixed! 


for (i = 0; i < times; i++) { 

char var[255]; 

sprintf(var, n RSS_FEED=%s n , feeds[i]); 
char *vars[] = {var, NULL}; 




Fiv-s*t, dall -povkO *to pvodcss. 


I*f -Po\rkO \rc-tu^cd 七 he 代 was a problem c\oW\^ ihe pvodcss. 


fprintf(stderr, "Can't fork process: %s\n”, strerror(errno)); 





^ \rc-tu\rhcd a O, the Codt is 

This is same 3s i-P (fid —— 0). <T〆" \ruhhih^ ih "the dhild pvo^css. 


I*f you jc-t hc\rc, youVc 七 he cW\\d pvodcss, 
so we should t'ActO -the sdv-ipt 

/usr/bin/python 1 


•/rssgossip.py' 


if (挪 cle r/us"1( fa r: ULL :::r 二 ” 


fpnntf (stderr, ” Can，t rim script: % s \ n ”，strerror (errno)) 
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Tqst DriVq 


Now, if you compile and run the code, this happens: 




> ./newshound 'pajama death' 

Pajama Death ex-drummer tells all. 

New Pajama Death album due next month. 

Photos from the surprise Pajama Death concert. 
Official Pajama Death pajamas go on sale. 

"When Pajama Death jumped the shark" by HenryW. 
Breaking News : Pajama Death attend premiere. 


I File Edit Window Help ReadAIIAboutlt 


Hey! Thafs 
great! ril send my 
photographers down 
to the premiere. 


By f ork-ing a copy of itself and then exec-ing the 
Python script in a separate process, the newshound 
program is able to run a separate process for each of the 
RSS feeds. And the great thing is that these processes will 

all run at the same time. 

This is you^* 

hcwshouhd 
P^rodcss. 


I 七 vuv>s 

七 he tWcc ， s*fccds. 


newshound 


TV tWiia fvotcsscs all 

m a 七 i\\t same Wc- 


That’s a lot faster than reading the newsfeeds one at a time. 
By learning how to create and run separate processes with 
fork () and exec (), not only can you make the most 
of your existing software, but you can also improve the 
performance of your code. 
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thereiore no o 

Dumb Questions 


Does system () run programs 
in a separate process? 

Yes. But system () gives you 
less control over exactly how the program 
runs. 

Isn’t fork-ing processes really 
inefficient? I mean, it copies an entire 
process, and then a moment later we 
replace the child process by doing an 
exec()? 

Operating systems use lots of tricks 
to make fork-ing processes really quick. 
For example, the operating system cheats 
and avoids making an actual copy of the 
parent process’s data. Instead, the child 
and parent processes share the same data. 

But what if one of the processes 
changes some data in memory? Won’t 
that screw things up? 

It would, but the operating system 
will catch that a piece of memory is going 
to change, and then it will make a separate 
copy of that piece of memory for the child 
process. 


That technique sounds quite cool. 
Does it have a name? 

Yes; it’s called “copy-on-write.” 

Is a pid_t just an int? 

It depends on the platform. The 
only thing you know is that it will be some 
integer type. 

I stored the result of a fork () 
call in an int, and it worked just fine. 

It’s best to always use pid_t to 
store process IDs. If you don’t, you might 
cause problems with other system calls 
or if your code is compiled on another 
machine. 

Why doesn’t Windows support 
the fork () system call? 

Windows manages processes very 
differently from other operating systems, 
and the kinds of tricks fork () needs to 
do in order to work efficiently are very hard 
to do on Windows. This may be why there 
isn't a version of fork () built in. 


But Cygwin lets me do fork () s 
on Windows, right? 

Yes. The gurus who work on 
Cygwin did a lot of work to make Windows 
processes look like processes that are 
used on Unix, Linux, and the Mac. But 
because they still need to rely on Windows 
to create the underlying processes, 
fork () on Cygwin can be a little slower 
than fork () on other platforms. 

So, if I’m just interested in writing 
code to work on Windows, is there 
something else I should use instead? 

Yes. There’s a function called 
CreateProcess () that’s like an 
enhanced version of system (). To find 
out more, go to http://msdn.microsoft.com 
and search for “CreateProcess.” 

Won’t the output of the various 
feeds get mixed up? 

The operating system will make sure 
that each string is printed completely. 


(^^BUllET POINTS - 

■ System calls are functions that live in 
the kernel. 

■ The exec () functions give you more 
control than system (). 

■ The exec () functions replace the 
current process. 


■ The fork () function duplicates the 
current process. 

■ System calls usually return -1 if they 
fail. 

■ Failed system calls set the errno 
variable to the error number. 
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Your C Toolbox 


You’ve got Chapter 9 under 
your belt，and now you’ve 
added processes and system 
calls to your toolbox. For a complete 
list of tooltips in the book, see 
Appendix ii. 


s ^0 
\. 心 a … o\c 

乙 0 州州冰厶 . 


cxcdio - lisi a^s. 
cxcdlcO — Iis£ of a\rgs + Chvi^ohmcht 
CXcdlpO — list a\rgs + oh path. 

cxcdvO - a^ay a^-gs. 

- a\r\ray <^f a\rgs + 

CXCdvpO - a\r\ray a\rgs + Oh path. I 


w) 

铣 C 6vaVVC^ 

^>V*o6CSS. 


-fov-kO + 
t%ttO 

dv-catcs a 

dhild p\rodcss. 
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10 Interprocess communiccttlpn 


^Ws good to talk ^ 



Creating processes is just half the story. 

What if you want to control the process once it’s running? What if you want to send it 
data? Or read its output? Interprocess communication lets processes work together to 
get the job done. Well show you how to multiply the power of your code by letting it talk 
to other programs on your system. 


this is a new chapter 
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redirection 


Redirecting input and output 


When you run programs from the command line, you can 
redirect the Standard Output to a file using the > operator: 

python . / rssgossip.py Snooki > stories.txt 

The Stahda\rd 
stdih 


You taY\ v-cd*ivcd*t ou 七 fu 七 
us'm^ > opcv-a*tov- 











Gh v-cdiv-c^-fc 
-to a -Pile. 


TV^c S*tair\davd 
Ou*tpvi*t ： s-tdout 


The Sta^dav-d 

B\r\ro\r ： stdev-v- 


The Standard Output is one of the three default data 
streams. A data stream is exactly what it sounds like: a 
stream of data that goes into, or comes out of, a process. 
There are data streams for the Standard Input, Output, 
and Error, and there are also data streams for other things, 
like files or network connections. When you redirect the 
output of a process, you change where the data is sent. So, 
instead of the Standard Output sending data to the screen, 
you can make it send the data to a file. 

Redirection is really useful on the command line, but is 
there a way of making a process redirect itself? 
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A look inside a typical process 

Every process will contain the program it’s running, as well as 
space for stack and heap data. But it will also need somewhere 
to record where data streams like the Standard Output are 
connected. Each data stream is represented by a file descriptor, 
which, under the surface, is just a number. The process keeps 
everything straight by storing the file descriptors and their data 
streams in a descriptor table. 


A iile descriptor is a 
nuititer tkat represents 
a data stream. 


A 

fv-odcss 



S 七扣 dav*d 

Standard Ou*tpu*t 
Sta^dav-d Evv-ov —^ 
The fvodcss also ^ 

i^ave o*thcv- ofc 灼 s*tvcams. 


# 

Data Stream | 

0 

The keyboard | 

1 

The screen | 

2 

The screen | 

3 

Database connection | 


The descriptor table has one column for each of the file 
descriptor numbers. Even though these are called file descriptors, 
they might not be connected to an actual file on the hard disk. 
Against every file descriptor, the table records the associated data 
stream. That data stream might be a connection to the keyboard 
or screen, a file pointer, or a connection to the network. 

The first three slots in the table are always the same. Slot 0 is 
the Standard Input, slot 1 is the Standard Output, and slot 2 is 
the Standard Error. The other slots in the table are either empty 
or connected to data streams that the process has opened. For 
example, every time your code opens a file for reading or writing, 
another slot is filled in the descriptor table. 

When the process is created, the Standard Input is connected to 
the keyboard, and the Standard Output and Error are connected 
to the screen. And they will stay connected that way until 
something redirects them somewhere else. 


File descriptors don’t 
necessarily refer to iiles* 
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replace the descriptors 


Redirection just replaces data streams 


The Standard Input, Output, and Error are always fixed in the same 
places in the descriptor table. But the data streams they point to can 
change. 



Sbhd 扣 d Output 

卜把 ^edi^-ted 

to a -file. 


That means if you want to redirect the Standard 
Output, you just need to switch the data stream against 
descriptor 1 in the table. 




# 

Data Stream 

0 

The keyboard 

1 

stories.txt 

2 

The screen 

3 

一 

Database connection 

— . _ ■ — 


So, that's why if s Z> … 

You can redirect the Standard Output and 
Standard Error on the command line using the 
> and 2> operators: 


/myprog > output.txt 2> errors.log 


All of the functions, like printf (), that send data 
to the Standard Output will first look in the descriptor 
table to see where descriptor 1 is pointing. They will 
then write data out to the correct data stream. 

Processes can redirect themselves 


Now you can see why the Standard Error is 
redirected with 2>.The 2 refers to the number 
of the Standard Error in the descriptor table. 
On most operating systems, you can use 1> as 
an alternative way of redirecting the Standard 
Output, and on Unix-based systems you can 
even redirect the Standard Error to the same 
place as the Standard Output like this: 


Every time you’ve used redirection so far, it’s been from 
the command line using the > and < operators. But 
processes can do their own redirection by rewiring the 
descriptor table. 


./myprog 2>&1 


2-> 七 

Standard &r\ro\r " 


fl w -fco the 
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filenoO tells you the descriptor 


Every time you open a file, the operating system registers a 
new item in the descriptor table. Let’s say you open a file with 
something like this: 

FILE *my file = fopen ( "guitar .mp3" , f, r n ); 



The operating system will open the guitar.mp3 file and return a 
pointer to it, but it will also skim through the descriptor table 
until it finds an empty slot and register the new file there. 

But once you’ve got a file pointer, how do you find it in the 
descriptor table? The answer is by calling the fileno () 
function. 


int descriptor 


fileno(my file); 


# 

Data Stream | 

0 

The keyboard | 

1 

The screen | 

2 

The screen | 

3 

Database connection | 

4 

File guitar.mp3 | 


his will \rc*tu\rh the value 午 . 


0 





fileno () is one of the few system functions that doesn’t return 
-1 if it fails. As long as you pass fileno () the pointer to an 
open file, it should always return the descriptor number. 


dupZO duplicates data streams 


Opening a file will fill a slot in the descriptor table, but what if 
you want to change the data stream already registered against 
a descriptor? What if you want to change file descriptor 3 to 
point to a different data stream? You can do it with the dup2 () 


function. dup2 () duplicates a data stream from one slot to 
another. So, if you have a file pointer to guitar.mp3 plugged in 
to file descriptor 4, the following code will connect it to file 
descriptor 3 as well. 


dup2(4, 3); 

There’s still just one guitar.mp3 file, and there’s still just one data 
stream connected to it. But the data stream (the FILE*) is now 



# 

Data Stream | 

0 

The keyboard | 

1 

The screen | 

2 

The screen | 

3 

File guitar.mp3 | 

4 

File guitar.mp3 | 


registered with file descriptors 3 and 4. 


Now that you know how to find and change 
things in the descriptor table, you should 
be able to redirect the Standard Output of a 
process to point to a file. 
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sleepless nights 


Does your error code worry you? 

Do you find that you，re writing duplicate error-handling code 
every time you make a system call? Then fear no more 1 Using 
our patented method, we’ll show you how to make the most out of 
your error code without writing the same thing over and over. 

Look at these two troublesome pieces of code ： 



pid—t pid = fork() 
if (pid :: -1) { 

fprintf(stderr, 
return 1; 


'Can't fork process : %s\n n , strerror(errno)) 

\ Puplitatcd code be tausc 

uy\v/av-v-ay\*tcd 乙。 d’” s*bress. 


if (execle (...)=: 
fprintf(stderr, 
return 1; 


- 1 ) 




'Can't run script: %s\n M , strerror(errno)); 


Is there some way of removing the duplicated code block? Why, yes, there is! By creating a 
simple fire-and-forget error() function, you，ll make your duplicated code a thing of the past. 

Whafs that, you say? How do you handle that troublesome return statement? After all, you 
can，t move that into a function, can you? 

There，s no need! The exit() system call is the fastest way to stop your program m its tracks. 
No more worrying about returning to main(); just call exit(), and your program s history. 

This is how it works. First, remove all of your error code into a separate function called 
error。and replace that tricky return with a call to exit(). To you have the exit 

void error (char *msg) sys-tcrw ta\\ available, you heed 

{ to ihdludc stdlib.h. 

exit(l); ^ wKDy/.ll Wmate y 歧 status I |_ 印 1 师 LY. 

Now you can replace that troublesome error-checking code with something much simpler ： 

pid—t pid = fork(); 
if (pid :: -1) { 

error ("Can't fork process ’'）； 


if (execle(...) :: -1) { 

error ("Can't run script ”）； 


Warning: offer limited to one exit O call per program execution. Do no 
you have a fear of sudden, program termination* 


t operate exit () if 
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The #ihdludcs oihd -the cv-v-ov-0 *fu^tioh 
have bcch \rcmovcd -to s^ve spa^c. 

si 


This is a program that saves the output of the rssgossip.py 
script into a file called stories.txt. It’s similar to the newshound 
program, except it searches through a single RSS feed only. Using 
what you’ve learned about the descriptor table, see if you can find 
the missing line of code that will redirect the Standard Output of 
the child process to the stories.txt file. 


int main(int arge, char ^argv[]) 

{ 

char *phrase = argv[1]/ 

char *vars[] = { n RSS_FEED=http :/ /www.enn.com/rss/celebs.xml ", NULL} 
FILE *f = fopen ( "stories.txt", n w n ); 

if ( ! f) { <^ - \( wc y/\r*rtc *to sWics-M, ( Will be z^ro. 

error ( "Can ' t open stories . txt" ) ; ^ IVlcll \rcpov-*t c\rv-ov-s usrnj c\rv-o\rO 


-fur\d*tio^ v/c v/\ro*tc C3\rlicv-. 


pid t pid = fork(); 


if (pid 


- 1 ) 


error ("Can't fork process"); 


if (!pid) 
if ( 


f do you tWmk joes here? 


error("Can't redirect Standard Output"); 

} 

if (execle (’▼/usr/bin/python", " / usr/bin/python ", 

phrase, NULL, vars) — -1) { 

error ( "Can't run script"); 

} 

} 

return 0; 


rssgossip.py , 



newshound2.c 


you are here ► 


435 












er 


return 



pid_t 
if (pi 
erro 


int main 

{ 

char ^ 
char ^ 
FILE 女 
if ( ! f 
erro 


Did you ge 

will change 
script to loc 

That means 
sends data ' 
appear in th 


standard output redirected 

- i^^irpen your pencil 


This is a program that saves the output of the rssgoss/p.py script 
into a file called stories.txt. It’s similar to the newshound 
program, except it searches through a single RSS feed only. Using 
what you’ve learned about the descriptor table, you were to find 
the missing line of code that will redirect the Standard Output of 
the child process to the stories.txt file. 



newshound2.c 


(mt argc, char *argv[]) 


phrase = argv[1]; 

vars [ ] = { n RSS_FEED=http :// www .cnn.com/rss/celebs.xml 1 
f = f open ("stories, txt n , n w f, ) ; 丁 op 加 -fo\r wiri 七 

){ 


r 


|-f -f > ； 3s z^vo ； v/C dould^*t (\\t- 

("Can't open stories.txt"); 


pid 
d = 
r 


: fork(); 
一 1) { 


("Can't fork process"); 

This todt dhild 

pv-odcss bedduse pid is 2 jCV-o. 




二二 - 


ror ( "Can't redirect Standard Output"); 


TKis fomts dtsCr\^ #1 
■to sW»cs.*t%*t -f ile- 


execle( n / usr/bin/python ", n / usr/bin/python ", 

phrase, NULL, vars) — -1) { 

ror("Can't run script"); 


rssgos 


0/ 


t the right answer? The program 
the descriptor table in the child 
>k like this: 

that when the rssgossip.py script 
to the Standard Output, it should 
le stories.txt file. 


# 

Data Stream | 

0 

The keyboard | 

1 

File stories.txt | 

2 

The screen | 


File stories.txt_| 


p 


f 


r 

e 


f 


436 Chapter 10 






















interprocess communication 



Tesr DriVq 


This is what happens when the program is compiled and 
run: 


This \ruhS the p\rogv-clrw. 

TKis displays i\\t CoY\itY\U 
o-f *tiiC s*to\rics.*t%*t -file- 

It Vou \rc Oh 3 W\v\do^js 

you II heed "to be v-uhhihj Cygwih. 


I File Edit Window Help ReadAIIAboutlt 




> . / newshound2 'pajama death' 

> cat stories.txt 

Pajama Death ex-drummer tells all. 

New Pajama Death album due next month. 


Tiic s*tovics dfet 
^ saved m 

s*tovid 七 -file- 


What happened? 

When the program opened the stories.txt file with f open (), 
the operating system registered the file f in the descriptor 
table, f ileno (f) was the descriptor number it used. The 
dup2 () function set the Standard Output descriptor (1) to 
point to the same file. 


O 


0 


I think there might be a 
problem with the program. 

See, I just tried the same thing, 
but on my machine the file was 
empty. So what happened? 


ih the 

file? WTf?l? ^ 


个 


I File Edit Window Help ReadAIIAboutlt 


> ./newshound2 'pajama death' 

> cat stories.txt 

> 


\/\/\)crcs The Fatts? 





Assuming you’re searching for stories that exist on the feed, why 
was stories.txt empty after the program finished? 
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hey, wait 


Sometimes you need to wait... 

The newshound2 program fires off a separate process to run 
the rssgossip.py script. But once that child process gets created, it’s 
independent of its parent. You could run the newshound2 
program and still have an empty stories.txt, jwst because the rssgossip.py 
isn’t finished yet. That means the operating system has to give you 
some way of waiting for the child process to complete. 



The waitpidO function 

The waitpid () function won’t return until the child process dies. 
That means you can add a little code to your program so that it 
won’t exit until the rssgossip.py script has stopped running: 


/ou heed -to ihdlude 

the sys/waith 



TWis variable used -to 如 re 
about pv-otess. 


This toAt ^ocs ― ^ 
a 七 *tKc cir>d o( 七 he 
y>ev/siiouir>dZ fvoyam. 



The P\ro^css ID 

return 0; 



Y^u add 

Options hc\rc. 
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waitpid () takes three parameters: 


axtplJO 


waitpict( 

fid, 

pid—status ， 

options 

) 


pid 

This is the process ID that the parent process was given when it forked 
the child. 



pid—status 

This will store exit information about the process, waitpid () will 
update it, so it needs to be a pointer. 



options 

There are several options you can pass to waitpid (), and typing 
man waitpid will give you more info. If you set the options to 0, the 
function waits until the process finishes. 


What's the status? 

When the waitpid () function has finished waiting, it 
stores a value in pid—status that tells you how the process 
did. To find the exit status of the child process, you’ll have 
to pass the pid—status value through a macro called 

WEXITSTATUS () : 

if (WEXITSTATUS (pid 一 status) ) ^~status «s ^oi z^\ro 

puts( "Error status non-zero"); 


Why do you need the macro? Because the pid—status 
contains several pieces of information, and only the first 8 bits 
represent the exit status. The macro tells you the value of just 
those 8 bits. 
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Tesr DriVq 


Now, when you run the newshound2 program, it checks that the 
rssgossip.py script finishes before newshound2 itself ends: 


The s-fcov-ics-t^-t 

-file doirtdms 
"the stories 


ds SOOY\ ds 

r>ev/shouruiZ is vu^. 


I File Edit Window Help ReadAIIAboutlt 


> ./newshound2 'pajama death' 

> cat stories.txt 

Pajama Death ex-drummer tells all. 

New Pajama Death album due next month. 



Adding a waitpid () to the program was easy to do and 
it made the program more reliable. Before, you couldn’t 
be sure that the subprocess had finished writing, and that 
meant there was no way you could use the newshound2 
program as a proper tool. You couldn’t use it in scripts and 
you couldn’t create a GUI frontend for it. 

Redirecting input and output, and making processes wait 
for each other, are all simple forms of interprocess 
communication. When processes are able to cooperate— 
by sharing data or by waiting for each other — they become 
much more powerful. 


BULLET POINTS 一 

■ exit () is a quick way of ending 
a program. 

■ All open files are recorded in the 
descriptor table. 

■ You can redirect input and output 
by changing the descriptor table. 


■ f ileno () will find a descriptor 
in the table. 

■ dup2 () can be used to change 
the descriptor table. 

■ waitpid () will wait for 
processes to finish. 
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tKeretare no o 

Dumb Questions 


Does exit () end the program 
faster than just returning from 
main()? 

No. But if you call exit ( ) ， you 
don’t need to structure your code to get 
back to the main () function. As soon as 
you call exit () , your program is dead. 

Should I check for -1 when I call 
exit (), in case it doesn’t work? 

No. exit () doesn’t return a value, 
because exit () never fails, exit () 
is the only function that is guaranteed 
never to return a value and never to fail. 

Is the number I pass to exit () 
the exit status? 

Yes. 

Are the Standard Input, Output, 
and Error always in slots 0,1, and 2 of 
the descriptor table? 

Yes, they are. 

So, if I open a new file, it is 
automatically added to the descriptor 
table? 

Yes. 


Is there a rule about which slot it 

gets? 

New files are always added to the 
available slot with the lowest number. So, 
if slot number 4 is the first available one, 
that’s the one your new file will use. 

How big is the descriptor table? 

It has slots from 0 to 255. 

The descriptor table seems kinda 
complicated. Why is it there? 

Because it allows you to rewire 
the way a program works. Without the 
descriptor table, redirection isn’t possible. 

Is there a way of sending data to 
the screen without using the Standard 
Output? 

On some systems. For example, on 
Unix-based machines, if you open 
/dev/tty, it will send data directly to the 
terminal. 

Can I use waitpid () to wait 
for any process? Or just the processes 
I started? 

You can use waitpid () to wait 
for any process. 


Why isn’t the pid_status in 
waitpid(..., &pid_status, 
...)just an exit status? 

Because the pid_status 
contains other information. 

Such as? 

A: For example, WIFSIGNALED 
(pid—status) will be false if 
a process ended naturally, or true if 
something killed it off. 

How can an integer variable like 
pid—status contain several pieces 
of information? 

It stores different things in different 
bits. The first 8 bits store the exit status. 
The other information is stored in the other 
bits. 

So, if I can extract the first 8 bits 
of the pid—status value, I don’t 
have to use WEXITSTATUS () ? 

It is always best to use 
WEXITSTATUS ()■ It’s easier to read 
and it will work on whatever the native 
int size is on the platform. 

Why is WEXITSTATUS () in 
uppercase? 

Because it is a macro rather than 
a function. The compiler replaces macro 
statements with small pieces of code at 
runtime. 
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don’t be a stranger 


Stay iw touch with your child 

You’ve seen how to run a separate process using exec () and 
fork (), and you know how to redirect the output of a child 
process into a file. But what if you want to listen to a child 
process directly? Is that possible? Rather than waiting for a 
child process to send all of its data into a file and then reading 
the file afterward, is there some way to start a process running 
and read the data it generates in real time? 


Reading story links from rssgossip 


As an example, there’s an option on the rssgossip.py script that 
allows you to display the URLs for any stories that it finds: 


•u *tclls sdvift *to mdludc s*tovy I'mks. 



TKis is URL 

-fov s*bo\ry. 


Now, you could run the script and save its output to a file, but 
that would be slow. It would be much better if the parent and 
child process could talk to each other while the child process is 
still running. 


Since I created 
you, you never write, 
you never phone... 


Pav •⑼七 p\rotcss 
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Connect your processes with pipes 


You’ve already used something that makes live connections 
between processes: pipes. 


The two pvo^csscs av-c 
with a pipe. 


vss^oss'if .py rts — ^ 

ou 七 fu 七 *m*to 七 lie fife. 


File Edit Window Help ReadAIIAboutlt 



yrt^ *thc 

ouifu*t o( 七 k sdvift 


python rssgossip.py -u 'pajama death' | grep 

http : //www.rock-news.com/exclusive/24.htm 
http : //www.rolling-stone.com/pdalbum.html 


grep 'http' 


Pipes are used on the command line to connect the output of 
one process with the input of another process. In the example 
here, you’re running the rssgossip.py script manually and then 
passing its output through a command called grep. The grep 
command finds all the lines containing http. 


Piped commands are parents and children 


Whenever you pipe commands together on the command line, 
you are actually connecting them together as parent and child 
processes. So, in the above example, the grep command is 
the parent of the rssgossip.py script. 



The command line creates the parent process 



The parent process forks the rssgossip.py 
script in a child process. 



The parent connects the output of the child 
with the input of the parent using a pipe. 



The parent process execs the grep command. 



o 

o 


iQ 

4 


n —— rss « ossip p y' 


Pipes are used a lot on the command line to allow users to 
connect processes together. But what if you’re just using G 
code? How do you connect a pipe to your child process so that 
you can read its output as soon as it’s generated? 
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Case study: opening stories m a browser 


Let’s say you want to run the rssgossip.py script and then 
open the stories it finds in a web browser. Your program 
will run in the parent process and rssgossip.py will run in the 
child. You need to create a pipe that connects the output of 
rssgossip.py to the input of your program. 

But how do you create a pipe? 


piped opens two data streams 

Because the child is going to send data to the parent, you 
need a pipe that’s connected to the Standard Output of the 
child and the Standard Input of the parent. You’ll create 
the pipe using the pipe () function. Remember how we 
said that every time you open a data stream to something 
like a file, it gets added to the descriptor table? Well, that’s 
exactly what the pipe () functions does: it creates two 
connected streams and adds them to the table. Whatever is 
written into one stream can be read from the other. 



This is ULOl ^ 
tvis is 


# 

Data Stream | 

0 

Standard input | 

1 

Standard output | 

2 

Standard error | 

3 5 

Read-end of the pipe | 

ki 

Write-end of the pipe | 


Gallic pifcO crcaics ihcsc i^o dcst\rip*tovs. 


is Wlrittch hcV"t.. 




⑺ __瓣 、、舶令土 W 。 


When pipe () creates the two lines in the descriptor table, 
it will store their file descriptors in a two-element array: 

dcsdvip-tov-s Will be 
〆 s-toved m *t^is av-vay- 

Yo[a pass -the name int fd[2]; 

o( i\\e a\r\ray -to f ( p i pe (fd) == -1) { 

tnc -ru^dxio^. 

error ("Can't create the pipe"); 


The pipe () command creates a pipe and tells you two 
descriptors: f d [ 1 ] is the descriptor that writes to the 
pipe, and f d [ 0 ] is the descriptor that reads from the 
pipe. Once you’ve got the descriptors, you’ll need to use 
them in the parent and child processes. 


Icffl] writes to 
tke pipe; fd[0] 
reacts from it. 
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Iw the child 


In the child process, you need to close the f d [ 0 ] end 
of the pipe and then change the child process’s Standard 
Output to point to the same stream as descriptor f d [ 1 ]. 

/TW»s v/»lUUc ^ read c"d J 

The ^hild v/ok /七 

\read -f\rorh "the pipe. close (fd [0] ) ； 丁 h 匕 hild "Bi ⑶ "the wv’rte 

du P 2 (fd[l], 1)7 g ^ d ^ A 似 



# 

Data Stream | 

0 

Standard input | 

1 

祕喊祕帽体祕 * Write-end of the pipe | 

2 

Standard error | 

3 


4 

Write-end of the pipe I 

—— -- - - 1 


That means that everything the child sends to the Standard 
Output will be written to the pipe. 


Tiic 匕 Wild 

y/oW ’七 vead 
-fvom 七 he pipe. 

"but will 


TW»s *»s -fdCI3, *t^c y/v-'»*tc c^d 
Jc 七 he 印 . 


In the parewt 


In the parent process, you need to close the f d [ 1] end 
of the pipe (because you won’t be writing to it) and then 
redirect the parent process’s Standard Input to read its data 

from the same place as descriptor f d [ 0 ]: /» . 

^—UC03 is the vead o-f -the pipe. 

y hc ^Ohhcd-b _> dup2 (fd[0] , 0); 

the read ehd -to the , , 」 r 丄 l • 

S-bhda^d Output close (fd[l]) / Tiiis W\W dost y/vi*tc tr\A ok fife. 



-®0 


# 

Data Stream | 

0 

of the pipe 

1 

Standard output | 

2 

Standard error | 

3 

Read-end of the pipe | 

4 



T\\t favcr\*t 
v/ill vead 
-fvom 
pipe … 

wok /七 

wv-i-tc 


Everything that the child writes to the pipe will be read 
through the Standard Input of the parent process. 
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ready-bake code 


Opening a web page m a browser 


Your program will need to open up a web page using the 
machine’s browser. That’s kind of hard to do, because 
different operating systems have different ways of talking to 
programs like web browsers. 

Fortunately, the out-of-work actors have hacked together 
some code that will open web pages on most systems. It looks 
like they were in a rush to go do something else, so they’ve 
put together something pretty simple using system () : 


void open_url(char 

{ 

char launch[255]; 
sprintf(launch, ” 
system(launch); 

This will a v/cb sprintf (launch," 

ov\ Lmu^c. t n x 

1 J system(launch); 

sprintf(launch," 
system(launch); 


keap9-BaK6 

■T 

Cw 


女 


url) 


This v/ill o^tY\ a >wcb ov\ l/V*mdo>ws. 


cmd / c start %s n , url); 


x-www-browser ' %s ' &’▼, url); 


open ' %s ' , url); 


This will open a v/cb pay on 七 he 





The code runs three separate commands to open a 
URL: that’s one command each for the Mac, Windows, and 
Linux. Two of the commands will always fail, but as long as 
the third command works, that’ll be fine. 



Piste 


Think you can write better code 
than the out-of-work actors? 
Then why not rewrite the code 

to use fork () and exec () for 

your favorite operating system? 
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Ex^f(ciSe 


It looks like most of the program is already written. All you need to do is complete the code that 
connects the parent and child processes to a pipe. To save space, the # include lines and the 
error () and open_url () functions have been removed. Remember, in this program the 
child is going to talk to the parent, so make sure that pipe’s connected the right way! 


int main(int argc ' char " argv[]) 

char *phrase = argv[1]; ( 

char *vars[] = {"RSS_FEED=http :/ /www.cnn.com/rss/celebs.xml ", NULL}; 

int f d [ 2 ] ; a\r\ray y/ill s-tov-c 七 he dcsC-irip-fcov-s -Po\r youir pipe. 

i<T~ Create youv 
fipc hc\rc. 

pid_t pid = fork(); 
if (pid — -1) { 

error ( "Can't fork process"); 

} you ov dKild? i/^at todc ^ocs m 払 esc Imcs? 

if ( !pid) { 

if (execle (’▼/usr/bin/python", f, / usr/bin/python ", n . / rssgossip . py n , 

n -u f ^ phrase, NULL, vars) — - 1) { 

error ( "Can ' t run script" ) ; 七 ells -the sdv-ift "to display 
} bet you m ov- ^iia ke? URLs (or sW.cs. 

} 1/VKa-t do you -to do -to fife? 

char line [255]; tfo W 

while (fgets (line, 255, ) ) { 七 Will you 

if (line[0] == ’\t ’）If ihc Imc starts wilh a tab … rtaA ^ om? 

open url (line + 1); 

} — ^-UsaWRL. 

return 0 / liioe + I is 七 he 七鹽 . 

a-Picv -the tab dhav-attev. 


news_opener.c 
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pipe connected 


SoLvtlOH 


It looks like most of the program is already written. You were to complete the code that connects 
the parent and child processes to a pipe. To save space, the #include lines and the 
error () and open url () functions have been removed. 


int main(int argc, char *argv[]) 

{ 

char *phrase = argv[1]; 

char *vars[] = { n RSS_FEED=http :/ /www.cnn.com/rss/celebs.xml ", NULL}; 

int fd [2 ] ; y/ill dv-catc the fife Bv\d s-fcovc its desdv-iftov-s m (dCOJ ar\d -fdCI]. 

. i；f . .(pipc(^d). .t.I) . [ . 

听七⑽也七 4 Need dhcdk that v-ctu\rh c,ode t 

j …………………… …… m 匕 ase we tav\i ercaic the pipe. 

pid t pid = fork(); 


if (pid 


- 1 ) 


error ("Can't fork process"); 

} ^ m i\\t dKild f\rotcss V^cvc. 

K ^dupZ(JPdCI3 D* 丁 h |S W| ll se 七仏 e Sta^dav-d Ou-tpu-t io the y/v-i-tc c^d o( -the pipe. 

doscC^dLOl^ 乩 lld 如 。〆 七 rcad 尖⑽七 ^ 户 P c , so “U 己 lose 七 he ^ad cr^d. 


if (execle (’▼/usr/bin/python" , f, / usr/bin/python ", 


■u ", phrase, NULL, vars) 


error ( "Can't run script"); 


} } V ou，v，c m fav ⑼七 pv-otess dovm iicv-c. 

切;. •七 This 如 11 代出咐七七 k Standaird l^u-t -to -the 代 ad ⑶ d o*f 七 he pipe. 

'This will dlosc the v/\ri*tc C^d o-P the fifC； 
char line [255] ; bedause pa\r ⑶七 won*t wrtc *to it 

while (fgets (line, 255, std.m ) ) { 

if (line [0] == ， \t ，） 

YouVc \reddi^ -fv-om -the Y® u also 

} Sta^dav-d I 吁此 because Kavc put (dC03. 

itg tuirn 0 } s Coy\v\cC^cdi "to 七 he 

pip 


open url (line + 1 )； 



- 1 ) 


news_opener.c 
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Tqst DriVQ 


When you compile and run the code, this happens: 


File Edit Window Help ReadAIIAboutlt 


> ./news opener 'pajama death 


That’s great. It worked. 

The news_opener program ran the rssgossip.py in a 
separate process and told it to display URLs for each story it 
found. All of the output of the screen was redirected through 
a pipe that was connected to the news_opener parent 
process. That meant the news_opener process could 
search for any URLs and then open them in the browser. 

Pipes are a great way of connecting processes together. 

Now, you have the ability to not only run processes and 
control their environments, but you also have a way of 
capturing their output. That opens up a huge amount of 
functionality to you. Your G code can now use and control 
any program that you can use from the command line. 


Rji.im.1 Dralh album dm* nrict month 


1 




PApma Uealh * 


t PajamA O^Ath a 


New Pajama Death album due next month 



Feb 28 Mar 1.2012 
Making Data Work Santa Cbra. CA 


9-use code CYBER60 


Most Popular » 



个 

opchs all 
ii 

ih -the bv-owsc^. 


—Off Piste - 

Now that you know how to control rssgossip.py, why not try controlling some of these 
programs? You can get all of them for Unix-style machines or any Windows machine 
using Cygwin: 

curl/wget 

These programs let you talk to web servers. If you call them from C code, you can write 
programs that can talk to the Web. 

mail/mutt 

These programs let you send email from the command line. If they’re on your machine, it means 
your C programs can send mail too. 

convert 

This command can convert one image format to another image format. Why not create a C 
program that outputs SVG charts in text format, and then use the convert command to create 
PNG images from them? 
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no dumb questions 


tKeretcire no o 

Dumb Questi9ns 


Is a pipe a file? 

It's up to the operating system how 
it creates pipes, but pipes created with the 
pipe () function are not normally files. 

So pipes might be files? 

It is possible to create pipes based 
on files, which are normally called named 
pipes or FIFO (first-in/first-out) files. 

Why would anyone want a pipe 
that uses a file? 

Pipes based on files have names. 
That means they are useful if two 
processes need to talk to each other and 
they are not parent and child processes. As 
long as both processes know the name of 
the pipe, they can talk with it. 


Great! So how do I use named 
pipes? 

Using the mkfifo () system call. 
For more information, see 
http://tinyurl. com/cdf6ve5. 

If most pipes are not files, what 
are they? 

Usually, they are just pieces of 
memory. Data is written at one point and 
read at another. 

What happens if I try to read from 
a pipe and there’s nothing in there? 

Your program will wait until 
something is there. 


How does the parent know when 
the child is finished? 

When the child process dies, the pipe 
is closed and the f gets () command 
receives an end-of-file, which means the 
f gets () function returns 0, and the 
loop ends. 

Can parents speak to children? 

Absolutely. There is no reason why 
you can't connect your pipes the other way 
around, so that the parent sends data to 
the child process. 

Can you have a pipe that works in 
both directions at once? That way, my 
parent and child processes could have 
a two-way conversation. 

No, you can’t do that. Pipes always 
work in only one direction. But you can 
create two pipes: one from the parent to 
the child, and one from the child to the 
parent. 


BULLET POINTS 


■ Parent and child processes can 
communicate using pipes. 

■ The pipe () function creates a 
pipe and two descriptors. 

■ The descriptors are for the read and 
write ends of the pipe. 


You can redirect Standard Input and 
Output to the pipe. 

The parent and child processes use 
different ends of the pipe. 
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The death of a process 

You’ve seen how processes are created, how their 
environments are configured, and even how processes talk to 
each other. But what about how processes die? For example, 
if your program is reading data from the keyboard and the 
user hits Gtrl-G, the program stops running. 


How does that happen? You can tell from the output 
that the program never got as far as running the second 
printf (), so the Gtrl-G didn’t just stop the f gets () 
command. Instead, the whole program just stopped in its 
tracks. Did the operating system just unload the program? 
Did the f gets () function call exit () ? What happened? 

The 0/S controls your program with signals 


#include <stdio.h> 

int main() 

{ ， 
char name[30]; 
printf ( "Enter your name : ’▼) 
fgets(name, 30, stdin); 
printf ("Hello %s\n n , name); 
return 0; 




I File Edit Window Help 


> ./greetings 
Enter your name : A C 

> 豕 


The magic all happens in the operating system. When you 
call the fgets () function, the operating system reads the 
data from the keyboard, and when it sees the user hit Gtrl-G, 
sends an interrupt signal to the program. 


|-f you pvess CVI-C, pvoyam 
s*tops vurmm 沴 Bu*t y/Wy? 



hits Ctvl-C. 

V 




: evrup 七 si^al- 

operating system 


Tlie p\rodcss \ruhs i-ts 


* he pvodcss 

default ihtc 


process 

hahdlc\r avsd ^alls cxi-tO. 


A signal is just a short message: a single integer value. When 
the signal arrives, the process has to stop whatever it’s doing 
and go deal with the signal. The process looks at a table of 
signal mappings that link each signal with a function called the 
signal handler. The default signal handler for the interrupt 
signal just calls the exit () function. 

So, why doesn’t the operating system just kill the program? 
Because the signal table lets you run your own code when 
your process receives a signal. 




This is the 
•mteinrupi si^hdl. 

SI^INT has 
•the value Z- 



TKc dc-faul-t Kav>dlcv tails 
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sigactionQ 


Catching signals and running your own code 


Sometimes you’ll want to run your own code if someone interrupts 
your program. For example, if your process has files or network 
connections open, it might want to close things down and tidy up 
before exiting. But how do you tell the computer to run your code 
when it sends you a signal? You can do it with sigactions. 


A sigaction is a function wrapper 


A sigaction is a struct that contains a pointer to a function, 
sigactions are used to tell the operating system which function 
it should call when a signal is sent to a process. So, if you have a 
function called diediedie () that you want the operating system 
to call if someone sends an interrupt signal to your process, you’ll 
need to wrap the diediedie () function up as a sigaction. 


This is how you create a sigaction: 


struct sigaction action; 

action.sa_handler = diediedie 

sigemptyset(&action.sa mask); 
，— ^c»r» scr 一 入、 

them -to z^vo. action. sa_flags = 0; ^^- 丁 | 

The function wrapped by a sigaction is called the handler, 
because it will be used to deal with (or handle) a signal that’s sent 


These some 

additiohal -flags. 

匕 jus-fc set 




to it. If you want to create a handler, it will need to be written in a 
certain way. 

All handlers take signal arguments 

Signals are just integer values, and if you create a custom handler 
function, it will need to accept an int argument, like this: 

void diediedie (int sig) This is the si^al 

{ ^ - - — 七 he Kdhdlcv* li^s 七 . 

puts ("Goodbye cruel world....\n"); 
exit (1); 


Create 9 

This is the hamc o-p -fclic 
you waht the ^omPutcv -fco dalI. 

y/v*df>s IS ddllcd d ^a\r\dlcv. 

^ask is a way o( 

，此 that the sija^tioh will hahdle. 

7 



you’ll usually ^Y\i *to use 
cmfty mask, like heve- 


Watch it! 


Be careful when 
writing to 
Standard Output 
and Error in 
handler functions. 


Even though the example code 
you’ll use will display text on 
the Standard Output, be careful 


Because the handler is passed the number of the signal, you can 
reuse the same handler for several signals. Or, you can have a 
separate handler for each signal. How you choose to program it is 
up to you. 


about doing that in more complex 
programs. Signals can arrive 
because something bad has 
happened to the program. That 
might mean that Standard Output 
isn’t available, so be careful. 


Handlers are intended to be short, fast pieces of code. They should 
do just enough to deal with the signal that’s been received. 
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sigactions are registered with sigactionO 

Once you’ve create a sigaction, you’ll need to tell the operating 
system about it. You do that with the sigaction () function: 

sigaction(signal no, &new action, &old action); 


sigaction () takes three parameters: 


o 

o 

o 


The signal number. 

The integer value of the signal you want to handle. Usually, you’ll pass^T" 
one of the standard signal symbols, like SIGINT or SIGQUIT. 

The new action. 

This is the address of the new sigaction you want to register. 

The old action. 


You II -f 'md out w>ov-C 
dbou*b 

siyaU’m 3 wWilc- 


If you pass a pointer to another sigaction, it will be filled with 
details of the current handler that you’re about to replace. If you don’t 
care about the existing signal handler, you can set this to NULL. 


The sigaction () function will return —1 if it fails and will also 
set the errno function. To keep the code short, some of the code 
you’ll see in this book will skip checking for errors, but you should 
always check for errors in your own code. 



The si^dl r^umbev* 


A *to 

4 


int catch signal(int sig, void (*handler)(int)) 


This is a function that will 
make it a little easier to 


struct sigaction action; av\ 


action.sa handler = handler 


register functions as signal 
In 3^ in dl er s • 

Use an cmfty mask. 一 > sigemptyset (&action. sa 一 mask); 

action.sa flags = 0; 


Set "the action’s {x> 

七 he hdrtdleir -tha-t 

was passed m. 


return sigaction (sig, &action, NULL); 

} 

^ctu\rh i\)c value of siga^tiohO, 
so you dah £.licdk -Po\r c\r\ro\rs. 

This function will allow you to set a signal handler by calling 
catch 一 signal () with a signal number and a function name: 


catch signal(SIGINT, diedieie) 
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Rewriting the code to use a signal handler 


You now have all the code to make your program do something if 
someone hits the Gtrl-G key: 


rtav^dilcv-s 
have >/o'»d 


#include <stdio.h> 

#include 〈signal • h>^^ You Y\ttd b> mdude 七 he s*i^v>al-V> i^cadcv*- 

#include <stdlib.h> 

\j /This ou\r r>cw signal ha^dlev-. 丄 

rid diediedie(int sig) ^ 

puts ("Goodbye cruel world....\n"); 
exit(1); 

} ^This is i\\t -fuy>d*t*iov> *to rtysitr a hair>dlcv-. 

V- 

int catch_signal(int sig, void (^handler)(int)) 

struct sigaction action; 
action.sa_handler = handler; 
sigemptyset(faction.sa_mask); 
action.sa flags = 0; 

l re 一一一 一判； 

rnc^Y\s wc 3\rc This sc*ts m*tcv*vuf*t har>dlcv* *to 

int main () the mt 州 rupt si^al. 七 he 七 0 心朽乙七 ion. 

{ v ^ 

if (catch—signal(SIGINT, handle—interrupt) == -1) { 

fprintf(stderr, "Can't map the handler"); 
exit (2); 

char name[30]; 

printf ( "Enter your name : ’▼); 
fgets(name, 30, stdin); 
printf("Hello %s\n n , name); 
return 0; 


The program will ask for the user’s name and then wait for her to type. 
But if instead of typing her name, the user just hits the Gtrl-G key, the 
operating system will automatically send the process an interrupt signal 
(SIGINT). That interrupt signal will be handled by the sigaction 
that was registered in the catch—signal () function. The 
sigaction contains a pointer to the diediedie () function. This 
will then be called, and the program will display a message and exit (). 
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Tqst DriVq 


When you run the new version of the program and press 
Gtrl-G, this happens: 

I File Edit Window Help 


> ./greetings 

Enter your name: A CGoodbye cruel world.... 

> —' — 


The operating system received the Gtrl-G and sent a 
SIGINT signal to the process, which then vdiiiyour 
handle interrupt () function. 



• + 


There are a bunch of different signals the operating system can send to 
your process. Match each signal to its cause. 


SIGINT 

The process was interrupted. 

SIGQUIT 

The terminal window changed size. 

SIGFPE 

The process tried to access illegal memory. 


Someone just asked the kernel to kill the 

SIGTRAP 

process. 

SIGSEGV 

The process wrote to a pipe that nothing’s 
reading. 

SIGWINCH 

Floating-point error. 

SIGTERM 

Someone asked the process to stop and dump 
the memory in a core dump file. 

SIGPIPE 

The debugger asks where the process is. 
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purpose found 


1 猶 









There are a bunch of different signals the operating system can send to 
your process. You were to match each signal to its cause. 


SIGINT 


SIGQUIT 


SIGFPE 


SIGTRAP 


SIGSEGV 


SIGWINCH 


SIGTERM 


SIGPIPE 



The process was interrupted. 

The terminal window changed size. 

The process tried to access illegal memory. 

Someone just asked the kernel to kill the 
process. 

The process wrote to a pipe that nothing’s 
reading. 

Floating-point error. 

Someone asked the process to stop and dump 
the memory in a core dump file. 

The debugger asks where the process is. 


Dumb 


are no o 

Questi9ns 


If the interrupt handler didn’t call exit () ， would the 
program still have ended? 


A: No . 


So, I could write a program that completely ignores 
interrupts? 

You could, but it’s not a good idea. In general, if your 
program receives an error signal, it’s best to exit with an error, 
even if you run some of your own code first. 
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Use kHI to send signals 


If you’ve written some signal-handling code, how do you test 
it? Fortunately, on Unix-style systems, there’s a command 
called kill. It’s called kill because it’s normally used to kill 
off processes, but in fact, kill just sends a signal to a process. 
By default, the command sends a SIGTERM signal to the 
process, but you can use it to send any signal you like. 


Cyjwm iV'mdows 


To try it out, open two terminals. In one terminal, you can run 
your program. Then, in the second terminal, you can send 
signals to your program with the kill command: 


ps displays you\r I File Edit Window Help 

乙 u\r\reh 七 pvo^csscs. 

This sends 
•fco p\ro^vam. 

This schds SI 令 IN 
"to the pirogv-am 

This scy\As 
*to pvoyam. 



> ps 

77868 ttys003 0 
78222 ttys003 0 

> kill 78222 

> kill -INT 78222 

> kill -SEGV 78222 

> kill -KILL 78222 


0:00.02 bash 
0:00.01 . /testprog 


TW»s is i\\t f\ro^aw v/C {p 

奶 d sisals -to. 

yotess IP. 


This stY\ds S|^Js|LL, whidh be ijhovcd. 


Each of these kill commands will send signals to the process 
and run whatever handler the process has configured. The 
exception is the SIGKILL signal. The SIGKILL signal can’t 
be caught by code, and it can’t be ignored. That means if you 
have a bug in your code and it is ignoring every signal, you can 
always stop the process with kill -KILL. 


Send signals with raiseO 


Sometimes you might want a process to send a signal to itself, 
which you can do with the raise () command. 


Sl^STOP be \y\ortd c'rthcv-. 

|*t’s used b> pause youv- fv-odcss. 


kill -KILL 

will always kill 
your program. 


raise(SIGTERM); 


Normally, the raise () command is used inside your own 
custom signal handlers. It means your code can receive a 
signal for something minor and then choose to raise a more 
serious signal. 


This is called signal escalation. 
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smell the coffee 


Sending your code a wake-up call 


The operating system sends signals to a process when something has 
happened that the process needs to know about. It might be that the 
user has tried to interrupt the process, or someone has tried to kill it, 
or even that the process has tried to do something it shouldn’t have, 
like trying to access a restricted piece of memory. 


But signals are not just used when things go wrong. Sometimes a 
process might actually want to generate its own signals. One example 
of that is the alarm signal, SIGALRM. The alarm signal is usually 
created by the process’s interval timer. The interval timer is like 
an alarm clock: you set it for some time in the future, and in the 
meantime your program can go and do something else: 


This will nrtdke the 
-Pi\rc ih IZO seconds. 


alarm (120); 


Mca^v/hilc, youv Code — ^ 
does somc*tK'm^ else. 


do_important—busy—work(); 
do more busy work(); 


But even though your program is busy doing other things, the timer 
is still running in the background. That means that when the 120 
seconds are up... 




Call'mj alav-mOZO) sets 
七 he alav-m -fov 12-0 
sttoY\ds \y\ *thc -fu*tuvc- 


the timer fires a SIGALRM signal 


When a process receives a signal, it stops doing everything else 
and handles the signal. But what does a process do with an alarm 
signal by default? It stops the process. If s really unlikely that you 
would ever want a timer to kill your program for you, so most of the 
time you will set the handler to do something else: 


丁 his will uit\\ the—^ 
s, 3^l us'mg the 

you dv-catcd 

cav-liev-. 



catch signal(SIGALRM, pour coffee); 


alarm(120); 


Q iC 





Alarm signals let you multitask. If you need to run a particular job 
every few seconds, or if you want to limit the amount of time you 
spend doing a job, then alarm signals are a great way of getting a 
program to interrupt itself. 



Don’t use 
alarm() and 
sleep() at 
the same 
time. 

The sleep () function puts 
your program to sleep for a 
few seconds, but it works 
by using the same interval 
timer as the alarm () 
function, so if you try to 
use the two functions at 
the same time, they will 
interfere with each other. 
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Resetting mi Ignoring signals Up C^s 


You’ve seen how to set custom signal handlers, but 
what if you want to restore the default signal handler? 
Fortunately, the signal.h header has a special symbol 

SIG DFL, which means handle it the default way. 


catch signal(SIGTERM, SIG DFL); 


Also, there’s another symbol, SIG—IGN ， that tells 
the process to completely ignore a signal. 

catch signal(SIGINT, SIG IGN); 


But you should be very careful before you choose to 
ignore a signal. Signals are an important way of 
controlling — and stopping~processes. If you ignore 
them, your program will be harder to stop. 



tKereiare no 

Dumb Qi] 


Questions 


Can I set an alarm for less than a second? 

Yes, but it’s a little more complicated. You need to use a 
different function called setitimer (). It lets you set the 
process’s interval timer directly in either seconds or fractions of a 
second. 

How do I do that? 

^ \ Go to http://tinyurl.com/3o7hzbm for more details. 

Why is there only one timer for a process? 

The timers have to be managed by the operating system 
kernel, and if processes had lots of timers, the kernel would go 
slower and slower. To prevent this from happening, the operating 
system limits each process to one timer. 


Timers let me multitask?! Great, so I can use them to do 
lots of things at once? 

No. Remember, your process will always stop whatever it’s 
doing when it handles a signal. That means it is still only doing one 
thing at a time. You’ll see later how you can really make your code 
do more than one thing at a time. 

What happens if I set one timer and it had already been 

set? 

Whenever you call the alarm () function, you reset the 
timer. That means if you set the alarm for 10 seconds, then a 
moment later you set it for 10 minutes, the alarm won’t fire until 10 
minutes are up. The original 10-second timer will be lost. 
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ExeRciSe 


This is the source code for a program that tests the user’s math skills. It asks the user to work 
the answer to a simple multiplication problem and keeps track of how many answers he got 
right.The program will keep running forever, unless: 

1. The user presses Ctrl-C, or 

2. The user takes more than five seconds to answer the question. 

When the program ends, it will display the final score and set the exit status to 0. 


#include 

#include 

#include 

#include 

#include 

#include 

#include 


<stdio.h> 
<stdlib.h> 
<unistd.h> 
<time.h> 
<string.h> 
<errno.h> 
<signal.h> 


int score = 0; 


void end 一 game(int sig) 

{ 

printf (’▼ \nFinal score : %i\n n , score); 

Wat should 

h^ppch ov\Ct . 

"the sdov-c is } 

displayed? 

int catch 一 signal(int sig, void (^handler) (int)) 

{ 

struct sigaction action; 
action.sa_handler = handler; 
sigemptyset(&action.sa_mask); 
action.sa_flags = 0; 

return sigaction (sig, &action, NULL); 
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void times_up(int sig) 

{ 

puts( n \nTIME'S UP!"); 

raise( ); 

} . 午 . 

Raise what? 

void error(char *msg) 

{ 

fprintf(stderr, "%s: %s\n ", msg, strerror (errno)); 
exit (1); 


int main() 


catch—signal(SIGALRM, 
catch—signal(SIGINT, 
srandom (time (0)); 

v-a^dorw irtumbev-s while (1) { 


This makes su\rc 
you yt di-P-Pcv-c^-t^^ 


:s> 


Will 

W\t si^alO 
-fu»r\£.*t«oy\S do? 


eddh -time- 


\P 


3 b v/ill be vay>dom y>umbcv*s -fvom O *to 10. 


int a = random() % 11; 

int b = random() % 11 

char txt [4] ; … what Ime is missmg? Meed io dhctk ihc sped... 


printf( n \nWhat is %i times %i? n , a, b); 
fgets(txt, 4, stdin); 
int answer = atoi (txt); 
if (answer — a * b) 
score++; 
else 

printf( n \nWrong! Score : %i\n n , score); 

} 

return 0; 
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t°^S ExeRclSe 
W^SotutvOH 


This is the source code for a program that tests the user’s math skills. It asks the user to work 
the answer to a simple multiplication problem and keeps track of how many answers he got 
right.The program will keep running forever, unless: 

1. The user presses Ctrl-C, or 

2. The user takes more than five seconds to answer the question. 

When the program ends, it will display the final score and set the exit status to 0. 


#include 

#include 

#include 

#include 

#include 

#include 

#include 


<stdio.h> 
<stdlib.h> 
<unistd.h> 
<time.h> 
<string.h> 
<errno.h> 
<signal.h> 


int score = 0; 


void end 一 game(int sig) 

{ 


printf (’▼ \nFinal score 

rn t 丄 〜⑽； 

the exit s-btus . 

O s-fcop. } 


%i\n", score); 


int catch—signal(int sig, void (^handler)(int)) 

{ 

struct sigaction action; 
action.sa_handler = handler; 
sigemptyset(&action.sa_mask); 
action•sa—flags = 0; 

return sigaction (sig, faction, NULL); 
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void times_up(int sig) 

{ 

puts ( n \nTIME'S UP !，▼); 
raise ( SI^INT 


void error (char *msg) 


〈aismg Sl^INT will make -the 
display -f mal sCort m ⑶ d—g 丑 mC (). 


fprintf(stderr, n %s: %s\n 
exit (1); 


msg, strerror (errno)); 




int main() 

{ 

catch—signal(SIGALRM, 七 ― P uf 

catch_signal(SIGINT, 

srandom ( time ( ° ))； 

v*a^dorw ^unr)be\rs while (1) { 

cadh -tirwc- int a = random () % 11; 

int b = random() % 11; 

char txt[4]; 

Set alav-m -to . 

-five m ^ sctor\ds. printf ("\nWhat is %i times %i? n , a, b); 

fgets(txt, 4, stdin); 

int answer = atoi (txt); 


As loh^ as you 
go thv-ough 
the loop ih less 
^ sc^ohds, 
the tir^cv will 

be \rcsct av\d \i 

will hCVCV -five. 


if (answer — a * b) 
score++; 
else 

printf( n \nWrong! Score 

} 

return 0; 


%i\n", score); 


TKc s»^alO 
’ sc*t 

r K3y\dlcv*s. 
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TesT DriVq 


To see if the program works, you need to run it a couple of times. 

Test 1: hit Ctrl - C 

The first time, you’ll answer a few questions and then hit Gtrl-G. 

Gtrl-G sends the process an interrupt signal (SIGINT) that makes the 
program display the final score and then exit (). 


The usc\r hit Ctv-I-C hcvc. 

TV^ fvoyam displayed fmal stove bcW ⑼ d’n ^ 々 


Test 1 : wait five seconds 


The second time, instead of hitting Gtrl-G, wait for at least five 
seconds on one of the answers and see what happens. 


The alarm signal (SIGALRM) fires. The program was waiting for the 
user to enter an answer, but because he took so long, the timer signal 
was sent; the process immediately switches to the times_up () 
handler function. The handler displays the “TIME’S UP!” message 
and then escalates the signal to a SIGINT that causes the program to 
display the final score. ,, 

o^...looks like 
Y/dS a r«Ulc slov/. 


Signals are a little complex, but incredibly useful. They allow 
your programs to end gracefully, and the interval timer can help 
you deal with tasks that are taking too long. 


File Edit Window Help 


> ./math 一 mas ter 

What is 0 times 1? 0 

What is 6 times 1? 6 

What is 4 times 10? 40 

What is 2 times 3? 6 

What is 7 times 4? 28 

What is 4 times 10? A C 
Final score : 5 

> 


File Edit Window Help 


> ./math 一 mas ter 

What is 5 times 9? 45 

What is 2 times 8? 16 

What is 9 times 1? 9 

What is 9 times 3? 
TIME'S UP! 

Final score : 3 

> 
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there ^ are no o 

Dumb Questi9ns 


Are signals always received in the 
same order they are sent? 

Not if they are sent very close 
together. The operating system might 
choose to reorder the signals if it thinks 
one is more important than the others. 


Is that always true? 


It depends on the platform. On 
most versions of Cygwin, for example, the 
signals will always be sent and received 
in the same order. But in general, you 
shouldn’t rely on it. 


If I send the same signal twice, 
will it be received twice by the process? 

Again, it depends. On Linux and the 
Mac, if the same signal is repeated very 
quickly, the kernel might choose to only 
send the signal once to the process. On 
Cygwin, it will always send both signals. 
But again, you should not assume that just 
because you sent the same signal twice, it 
will be received twice. 


BULLET POINTS - 

■ The operating system talks to 
processes using signals. 

■ Programs are normally stopped 
using signals. 


■ The interval timer sends si galrm 
signals. 

■ The alarm () function sets the 
interval timer. 


■ When a process receives a signal, it 
runs a handler. 

■ For most error signals, the default 
handler stops the program. 

■ Handlers can be replaced with the 
signal () function. 

■ You can send signals to yourself with 

raise (). 


■ There is one timer per process. 

■ Don't use sleep () and alarm () 

at the same time. 

■ kill sends signals to a process. 

■ kill -kill will always kill a 
process. 
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Your C Toolbox 


You’ve got Chapter 10 
under your belt，and now 
you’ve added interprocess 
communication to your toolbox. For 
a complete list of tooltips in the book, 
see Appendix ii. 


抑 


-PilchoO 

-fihds 

dcsd\rip*to\r. 


waitpidO 
waits a 

f\rodcss -to 
-fihish. 


data s-tvcdw 


⑽如 a 






Sisals 
messages 
-Pv-om *thc 
0/S. 


P^rodcsscs 乙如 
亡 ommuhi 匕 

usihg pipes. 


lets y 
V^dle 


Ol 


tv^c wai 

se^ds a 


A pvojiram 
sad sisals 
*t° iiself with 
^iseO. 


3l3\rm0 scv\ds 
a Ql^ALRM 
afier a -fev/ 

sctoy\ds. 
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11 sockets and networking 

’ There’s no place ♦ 

^ like 127.0.0.1^ 



Programs on different machines need to talk to each other. 

You’ve learned how to use I/O to communicate with files and how processes on the same 
machine can communicate with each other. Now you’re going to reach out to the rest 
of the world, and learn how to write C programs that can talk to other programs across 
the network and across the world. By the end of this chapter, you’ll be able to create 
programs that behave as servers and programs that behave as clients. 


this is a new chapter 


knock-knock server 


The Internet knock-knock server 

G is used to write most of the low-level networking code on the 
Internet. Most networked applications need two separate programs: 

a server and a client. 

You’re going to build a server in G that tells jokes over the Internet. 
You’ll be able to start the server on one machine like this: 



You’ll be using 
telnet quite a 
lot in this 
chapter to test 
our server code. 


I File Edit Window Help KnockKnock 


> ./ikkp 一 server 
Waiting for connection 


Other than telling you it’s running, the server won’t display anything 
else on the screen. However, if you open a second console, you’ll be 
able to connect to the server using a client program called telnet. 
Telnet takes two parameters: the address of the server, and the port 
the server is running on. If you are running telnet on the same 
machine as the server, you can use 127.0.0.1 for the address: 


If you try to use the built-in 
Windows telnet, you might have 
problems because of the way it 
communicates with the network. 
If you install the Cygwin version 
of telnet, you should be fine. 


ZOOOO is i\\t mJotr Jc \>ov*t 


Use 12 - 1 . 0 . 0.1 i-p youVc v*uhhih^ 

the sc\rvc\r oh the Sdr^e 你把 hihC. 


TilC SCV"VCV lias \rCSfOir\dcd- 一 
V® u "type ih these \TCSpohSCS. ^ 



Da this! - ► 


You will need a telnet program in order to 
connect to the server. Most systems come 
with telnet already installed. You can 
check that you have telnet by typing: 

telnet 

on the command line. 

If you don’t have telnet, you can install it 
in one of these ways: 


Cygwin: 

Run the setup . exe program for 
Cygwin and search for telnet. 

Linux: 

Search for telnet in your package manager. 
On many systems, the package manager 
is called Synaptic. 

Mac: 

If you don’t have telnet, you can install it 
from www.macports.org or 
www.finkproject.org. 
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Knock-knock server overview 


The server will be able to talk to several clients at once. The client 
and the server will have a structured conversation called a protocol. 
There are different protocols used on the Internet. Some of 
them are low-level protocols, like the internet protocol (IP), which 
are used to control how binary Is and Os are sent around the 
Internet. Other protocols are high-level protocols, like the hypertext 
transfer protocol (HTTP), which controls how web browsers talk to 
web servers. The joke server is going to use a custom high-level 
protocol called the Internet knock-knock protocol (IKKP). 


A protocol is 
a structured 
conversation. 



Server 


f\ dlicr^t d^d sewev iiavc 
d s*tvut*tuvcd dor>vcvsatior\ 
匕 ailed a pvo-to^ol. 


Telnet client 

The sc\rvc\r will talk io 

several dlichts at ov\tc. 


The client and the server will exchange messages like this: 


Telnet client 


Server: 

Knock knock! 


Client: 


Who's there? 


Oscar. 


Oscar who? 


Oscar silly question, you 
get a silly answer. 


A protocol always has a strict set of rules. As long as the client and 
the server both follow those rules, everything is fine. But if one of 
them breaks the rules, the conversation usually stops pretty abruptly. 
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blab 


PLAP: how servers talk to the Iwtcrwct 


When G programs need to talk to the outside world, they use 
data streams to read and write bytes. You’ve used data 
streams that are connected to the files or Standard Input and 
Output. But if you’re going to write a program to talk to the 
network, you need a new kind of data stream called a socket. 


rou 


’ll heed *tWis Kcadcv- 


lis-tchC\r__d is a dcsd\rip-fcov- 
-Po\r the socket. 


\{!s av\ \v\itrY\ti socket. 


#include <sys/socket.h> 

••• 

int listener_d = socket(PF 一 INET, SOCK 一 STREAM 

if (listener d — -1) 


0) 


This is d 
fV*o*todol hurwbev. 
You tSy\ leave it 
as O. 


error ("Can't open socket"); 


Before a server can use a socket to talk to a client program, 
it needs to go through four stages that you can remember 
with the acronym BLAB: Bind, Listen, Accept ， Begin. 


1. Piwd to a port 


TWis is 

CV"V"OV "0 

you Crtdiitd m 

i\\t last 


A computer might need to run several server programs at 
once. It might be sending out web pages, posting email, and 
running a chat server all at the same time. To prevent the 
different conversations from getting confused, each server 
uses a different port. A port is just like a channel on a TV 
Different ports are used for different network services, just 
like different channels are used for different content. 

When a server starts up, it needs to tell the operating 
system which port it’s going to use. This is called binding 
the port. The knock-knock server is going to use port 
30000, and to bind it you’ll need two things: the socket 
descriptor and a socket name. A socket name is just a 
struct that means “Internet port 30000.” 


Bind to a port. 
Listen. 

Accept a connection. 
Begin talking. 



Wlcb: po\rt 
Entail- po\rt Z 弓 . 

Cha 七 : pov-*t 弓 m 
Jokes ： pov-t ZOOOO. 


U'ukki. 'tmit.,71 


#include <arpa/inet.h> 


)U 1I (or addvesscs. 



These Imes d\rcaic a -Pov -the 
po\rt Uewt fov-t ZOOOO. ,> 


struct sockaddr_in name; 
name. sin_f amily = PF_INET 
name. sin_j>ort = (in_port_t) htons (30000); 
name. sin_addr. s_addr = htonl (INADDR_ANY); 
int c = bind (listener d, (struct sockaddr *) &name , sizeof(name)) 


if (c 


- 1 ) 


error ("Can't bind to socket"); 
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1 . listen 


If your server becomes popular, you’ll probably get lots of clients 
connecting to it at once. Would you like the clients to wait in a 
queue for a connection? The listen () system call tells the 

operating system how long you want the queue to be: f . 七 Vi a 10- 


if (listen (listener_d, 10)=: 
error("Can't listen"); 


- 1 ) 




Galling listen () with a queue length of 10 means that up to 
10 clients can try to connect to the server at once. They won’t all 
be immediately answered, but they’ll be able to wait. The 11th 
client will be told the server is too busy. 



3 . Accept a connection 


丁 he -Pi\rS"t lO dlichts 
will be able -to wait 


V 

TKc H*tV^ 

y/*»|| be -told *tv^c 
scv*vcv" is *too busy* 


Once you’ve bound a port and set up a listen queue, you then 
just have to.. .wait. Servers spend most of their lives waiting for 
clients to contact them. The accept () system call waits until a 
client contacts the server, and then it returns a second socket 
descriptor that you can use to hold a conversation on. 

d.wt 一 addv will s*tovc details about 

struct sockaddr—storage client_addr; 七 he dl ’ 咖七 v/ho s jus 七 doomed 七 ed. 
unsigned int address 一 size = sizeof(client 一 addr); 

int connect_d = accept(listener_d, (struct sockaddr *)&client_addr, &address 一 size 
if (connect_d == -1) 

error("Can't open secondary socket"); 


This new connection descriptor (connect_d) is 

the one that the server will use to... 


Begin talking. 




Why do you think the accept () system 
call creates the descriptor for a new 
socket? Why don’t servers just use the 
socket they created to listen to the port? 
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A socket's wot your typical data stream 


So far, data streams have all been the same. Whether you’re 
connected to files or Standard Input/Output, you’ve been able 
to use functions like fprintf () and f scanf () to talk to 
them. But sockets are a little different. A socket is two way\ it 
can be used for input and output. That means it needs different 
functions to talk to it. 


If you want to output data on a socket, you can’t use 
fprintf () . Instead, you use a function called send () : 


TVis is 七 ^ message youVc 50^5 
•bo stv\A ovcv i\\t 


l4 


char *msg = n Internet Knock-Knock Protocol Server\r\nVersion 1.0\r\nKnock! 
if (send(connect d, msg, strlen(msg), 0) == -1) 


error (’ ▼ send") 


rw,s 


s 


otkc*t 

dcstv-'»p*bov*. 


=^ be as 0. 


TKc -f mal fav-a^c-tcv- is used -fov- aA^ud 


Knock!\r\n> "; 


Remember: it’s important to always check the return 
value of system calls like send () . Network errors are really 
common, and your servers will have to cope with them. 


( 濰 6ee} Bits - 

What port should I use? 

You need to be careful when you choose a port number for a server application. There are lots 
of different servers available, and you need to make sure you don’t use a port number that’s 
normally used for some other program. On Cygwin and most Unix-style machines, you’ll find 
a file called /etc/services that lists the ports used by most of the common servers. When you 
choose a port, make sure there isn’t another application that already uses the same one. 

Port numbers can be between 0 and 65535, and you need to decide whether you want to 
use a low number (< 1024) or a high one. Port numbers that are lower than 1024 are usually 
only available to the superuser or administrator on most systems. This is because the low port 
numbers are reserved for well-known services, like web servers and email servers. Operating 
systems restrict these ports to administrators only, to prevent ordinary users from starting 
unwanted services. 

Most of the time, you'll probably want to use a port number greater than 1024. 
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TKc mtludcs av-c v-cmovcd 
-to save spate. 

int main(int arge, char *argv[]) 


This server generates random advice for any client that connects to it, 
but it’s not quite complete. You need to fill in the missing system calls. 
Also, this version of the code will send back a single piece of advice 
and then end. Part of the code needs to be inside a loop. Which part? 


char ^advice[] = { 

"Take smaller bites\r\n M , 

"Go for the tight jeans. No they do NOT make you look fat.\r\n n , 

"One word : inappropriate\r\n ", 

"Just for today, be honest. Tell your boss what you *really* think\r\n M , 
"You might want to rethink that haircut\r\n" 


int listener_d = 


(PF_INET, SOCK_STREAM, 0); 


struct sockaddr—in name; 

name•sin—family = PF—INET; 

name•sin—port = (in_port_t)htons(30000); 

name.sin_addr.s_addr = htonl(INADDR—ANY); 

(listener—d, (struct sockaddr *) &name, sizeof(name)); 


(listener—d, 10); 
puts("Waiting for connection"); 


struct sockaddr_storage client—addr; 

unsigned int address_size = sizeof(client—addr); 

int connect—d = (listener_d, (struct sockaddr *)&client_addr, &address_size); 

char *msg = advice[rand() % 5]; 


(connect_d, msg, strlen(msg), 0); 
close(connect_d); 


return 0; 


And for a bonus point, if you add in the missing #include statements, the program will work. But what has 
the programmer missed out? Hint: look at the system calls. 

The programmer has forgotten to 
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code written 


c^Sharpen your pencil 

Solution 


This server generates random advice for any client that connects to it, 
but it’s not quite complete. You needed to fill in the missing system calls. 
Also, this version of the code will send back a single piece of advice and 
then end. Part of the code needs to be inside a loop. Which part? 


int main(int argc, char *argv[]) 

{ 

char ^advice[] = { 

"Take smaller bites\r\n M , 

"Go for the tight jeans. No they do NOT make you look fat.\r\n ", 

"One word : inappropriate\r\n ", 

"Just for today, be honest. Tell your boss what you *really* think\r\n ", 

"You might want to rethink that haircut\r\n" 

}； 

int listener_d = .(PF_INET, SOCK_STREAM, 0); Cv-C3*tc a socket- 

struct sockaddr—in name; 
name•sin—family = PF_INET; 
name•sin—port = (in_port_t)htons(30000); 
name.sin_addr.s—addr = htonl ( 工 NADDR—ANY); 

.. (listener_d, (struct sockaddr *) 

lisieh (listener—d, 10) ; < — Set 10. 

puts("Waiting for connection"); 

while (I) { ^ —— V^ou r\ccd *to I oof the addept/bej'm talk'mj 

struct sockaddr—storage client—addr; 

unsigned int address_size = sizeof(client—addr); 

int connect d = (listener d, (struct sockaddr *)&client addr, &address size); 

— . 4 . L— — — 

char *msg = advice [rand () % 5]; ^ a a 

SCY\d (connect—d, msg, strlen (msg) , 0); 

close (connect d); 民 d • , 

j _ talking -to the dlicht. 

return 0; 


B'md tiic soCkti bo ZOOOO. 



&name, sizeof(name)); 


And for a bonus point, if you add in the missing #include statements, the program will work. But what has 

the programmer missed out? Hint: look at the system calls. , a , i l. j 卜丄 - 

t r ^^ Vou should always ^ sodket bmd, 

The programmer has forgotten to cMtCX +o\r errors. .addeft ov stv\A vrtum — I. 
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sockets and networking 



Tqst DriVQ 


Let’s compile the advice server and see what happens. 


File Edit Window Help I'mTheServer 


> gcc advice 一 server•c -o advice 一 server 

> ./advice 一 server 
Waiting for connection 


Then, while the server is still running, open a second console and 
connect to the server using telnet a couple of times. 


File Edit Window Help I’mTelnet 


> telnet 127.0.0.1 30000 
Trying 127.0.0.1... 

Connected to localhost. 

Escape character is ' A ]'. 

One word: inappropriate 
Connection closed by foreign host. 

> telnet 127.0.0.1 30000 
Trying 127.0.0.1... 

Connected to localhost. 

Escape character is ' A ]'. 

You might want to rethink that haircut 
Connection closed by foreign host. 

> — 


That’s great, the server works. Here, you’re using 127.0.0.1 as the IP 
address, because the client is running on the same machine as the 
server. But you could have connected to the server from anywhere 
on the network and we’d have gotten the same response. 
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starting problems 


Sometimes the server doesn't start properly 



o O 



Scv-vcv- 

tOhSoIc 


I File Edit Window Help rmTheServer 


> ./advice 一 server 
Waiting for connection 





CliCht 乙 ohsole 


丁 he sc\rvc\rs s*b 士 d. 

TVic server scr^ds ba^k d — ^ 


File Edit Window Help I’mTheClient 


> telnet 127.0.0.1 30000 
Trying 127.0.0.1... 

Connected to localhost. 

Escape character is ' A ]'. 

One word: inappropriate 
Connection closed by foreign host 

> * 


Scv-vcv- to^solc 


...but then, if I stop the 
server and restart it real 
quick, the client can’t get 
a response anymore! 


Ctv-I-C 

kills -the 
SCV-VCV-. 



> ./advice 一 server 
Waiting for connection 
A C 

> ./advice 一 server 
Waiting for connection 


Clicht ^ohsole 


TV^c servers \rcs*tav-*tcd. 




File Edit Window Help I’mTheClient 


> telnet 127.0.0.1 30000 
Trying 127.0.0.1... 

telnet : connect to address 127.0.0.1: Connection refused 
telnet : Unable to connect to remote host 命 


The server looks like it’s starting correctly the second time, 
but the client can’t get any response from it. Why is that? 

Remember that the code was written without any error 
checking. Let’s add a little error check into the code and 
see if we can figure out what’s happening. 


WTf??l?l?? 



T\\t Fccdbadk???? 
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sockets and networking 


Why your mom always told you to check for errors 


If you add an error check on the line that binds the socket to a 
port: 

if (bind (listener d, (struct sockaddr *) &name, sizeof(name)) 




•.."to -this 



- 1 ) 


error ("Can bind the port ”）； TWs 心 3 || 叫如 cvvov* -fuy>d*tioy> you v/vo*tc d v/iVile 

bade. I*t Will display the dausc o( Uc error c^it 


Then you’ll get a little more information from the server if it is 
stopped and restarted quickly: 


The bihd -Pail 


s 




File Edit Window Help I’mTheServer 


> ./advice 一 server 
Waiting for connection 
A C 

> ./advice 一 server 

Can't bind the port: Address already in use 

> 


If the server has responded to a client and then gets stopped and 
restarted, the call to the bind system call fails. But because the 
original version of the program never checked for errors, the rest 
of the server code ran even though it couldn’t use the server port. 


Pound ports arc sticky 


When you bind a socket to a port, the operating system will 
prevent anything else from rebinding to it for the next 30 
seconds or so, and that includes the program that bound the port 
in the first place. To get around the problem, you just need to set 
an option on the socket before you bind it: 

You need ^ ml variable *to sW ofW- 

Setb 叫丨七 "to I w>car\s V Y CS > V-CUSC 

int reuse = 1 ; 匕 J 

if ( setsockopt(listener 一 d, SOLJSOCKET, SO 一 REUSEADDR, 

error("Can't set the reuse option on the socket"); 


This code makes the socket reuse the port when it’s bound. 
That means you can stop and restart the server and there will be 
no errors when you bind the port a second time. 


ALWAYS ckeck lor 

errors on system calls. 

(char *)&reuse, sizeof(int)) == -1) 

个 

TV_s makes -the socket vcusc the pov-fc. 
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recvQ 


Reading from the client 


You’ve learned how to send data to the client, but what about reading from the 
client? In the same way that sockets have a special send () function to write 
data, they also have a reev () function to read data. 


〈bytes read> = reev(<descriptor>, <buffer>, Cbytes to read>, 0); 


If someone types in a line of text into a client and hits return, the reev () 
function stores the text into a character array like this: 




There are a few things to remember: 


VCdvO V/'llI v*c*tuvir> 
value because -theve 
av-c W dV>av-ad*tc\rs stY\i 
-fvom *tV>C 


o 

o 

o 

o 


The characters are not terminated with a \0 character. 

When someone types text in telnet, the string always ends \r\n. 

The recv() will return the number of characters, or -1 if there's an error, or 
0 if the client has closed the connection. 

You're not guaranteed to receive all the characters in a single call to recv(). 


This last point is important. It means you might have to call reev () more 
than once: 

That means reev () can be tricky to use. It’s best to wrap reev () in a 
function that stores a simple \0-terminated string in the array it’s given. 


You *to 

v-ctv() a ^ 七 iwcs 
y 七 all ttc 


Something like this: 


int read in (int socket, char *buf, int len) 


TWis veads all evaders 

u^-b'il \i 'reaves V. 


char *s = buf; 
int slen = len; 

int c = reev(socket A s, slen, 0); 
while ( (c > 0) && (s[c-1] != '\n')) { 

s += c; slen —— c; 
c = reev(socket, s, slen, 0); 

} 

if (c < 0) I 的 -thcv-c^s ar\ cvvov 

return c ; 么 

else if (c == 0) Koth'mg v-cad ； schd 

buf [0] = ' \0 ' ; ba^k av\ empty sVmg. 

else 

s[c-l]= , \0 , ; 
return len - slen; 


Uhtil av-c ho 
^ha\rol^-tc\rs o\r you v-Coldh { \ y \. 


Reflate ^ , 

a "\0 



feoff piste 


This is one way of 
simplifying reev (), 
but could you do 
better? Why not write 
your own version of 
read 一 in () and let US 
know at headfirstlabs.com. 
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sockets and networking 


)g> E) Q^j 

~ ■ ■ -v 

Cppe 


Here are some other functions that are useful when you are 
writing a server. Do you understand how each of them works? 


pisflay 


C\r\ro\r... 


void error(char *msg) 

fprintf(stderr, "%s: %s\n ", msg, strerror (errno)); 
exit (1) ; stop the pv-og^ar,. 


^ You’Ve used this tYYoY -Puhdtioh 
a LOT ih this book. 



tall *tKis -fur\d*t'ior\ i-f you 
Y/a 於七払 e pvoyam -to keep \rurmm 汐 



Crcaic av\ \v\itrv\ti s-tveam'm^ sodket 


Vcs, \rcusc 七 he sodkei (so you cav\ 
\rcsta\rt -the sc\rvc\r v/iihoui problems). 


int open_listener_socket() 

int s = socket(PF—INET, SOCK—STREAM, 0) 
if (s == -1) 

error("Can't open socket"); 
return s; 



void bind_to_port(int socket, int port) 

struct sockaddr_in name; is |r\*tcvr\c*t fovt ZOOOO. 

name.sin_family = PF INET; 
name.sin_port = (in_port_t)htons(30000); 
name.sin_addr.s—addr = htonl(INADDR—ANY); 
int reuse = 1; 

if (setsockopt(socket, SOL—SOCKET, SO—REUSEADDR, (char *)&reuse, sizeof(int)) 
error("Can't set the reuse option on the socket"); 
int c = bind (socket, (struct sockaddr *) &name, sizeof(name)); 
if (c == -1) 

error("Can't bind to socket"); 


==- 1 ) 

^v*ab po\rt iOOOO. 


int say (int socket, char *s) 4 ： ^^ Schd a stv-ihg -to a dlicht. 

{ po^-t dall cvvovO i-f Neve's a problem. 

int result = send (socket, s, strlen {s) r 0) ; You v/o^*t *to s-tof sevvev- i-f 

if (result == -1) ^ tiicvcs just d pvoblc^ or\C 

fprintf (stderr, "%s: %s\n f, , "Error talking to the client ”， strerror (errno)) 
return result; 


Now that you have a set of server functions, let’s try them out... 
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server unwritten 



ExeRciSe 


Now it’s time to write the code for the Internet knock-knock server. You're going to write a 
little more code than usual, but you'll be able to use the ready-bake code from the previous 
page. Here’s the start of the program. 


#include 

#include 

^include 

#include 

#include 

^include 

#include 

#include 


<stdio.h> 
<string.h> 
<errno.h> 
<stdlib.h> 
<sys/socket.h> 
<arpa/inet.h> 
<unistd.h> 
<signal.h> 




The v-cady-bakc -fur>d*tioy>s -fvom pvcvious pay i^cv-c- 
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sockets and networking 


Now it’s over to you to write the main function. You’ll need to create a new server socket and store it in listener—d. 
The socket will be bound to port 30000, and the queue depth should be set to 10. Once that’s done, you need to write 
code that works like this: 



)Chec^ 七 ha 七 "they say ； a oscar u)ho? }1 

I ^ 


1 


\ say ； a oscar s\Wy question 
you o^e-t a s\Wy 8nsu)0r )} 




Try to check error codes and if the user says the wrong thing, just send an error message, close the connection, and 
then wait for another client. 

Good luck! 
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server written 



t°^S ExeRclSe 
^SotutvOH 


Now it’s time to write the code for the Internet knock-knock server. You were to write a little 
more code than usual, but you'll be able to use the ready-bake code from the previous page. 
Here’s the start of the program. 


#include 

#include 

^include 

#include 

#include 

^include 

#include 

#include 


<stdio.h> 
<string.h> 
<errno.h> 
<stdlib.h> 
<sys/socket.h> 
<arpa/inet.h> 
<unistd.h> 
<signal.h> 




The v-cady-bakc -fur>d*tioy>s -fvom pvcvious pay i^cv-c- 
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sockets and networking 


This is the kind of code you should have written. Is yours similar? It doesn’t matter if the code is exactly the same. The 
important thing is that your code can tell the joke in the right way, and cope with errors. 




TK'is W\W dall \\diy\A\t sV>u*tdo>wir >0 \( C*tv-I-C is hit 


i-f (da*t6h_siy^l(S|4INT, handle 一 slurtdowh) 
cvrorO'Ca^^-t sc*t *tKc m*tcr\rup*t handler )； 
listenev_d 二 opcr\_lis*tchc\r_sodke*t0; 

bmd 一 *fco 一 po\rt(lis*tehev 一 d, ^0000); Create a sodkrt oy\ pov-t ZOOOO. 

i-f Ois*tchOistchcr_d, 10) =■= - -I) ^ - Se 七七 he lis-tc^-^ucuc *to 10. 

ev\ro\r(“C3h ’ 七 lis-tc^O ； 
s*brud*t sodkaddv-^s-torage dlich-t^addr ； 

Uhsi^hed m 七 address^siz^ =■ sizjCaf(dierrt_adWr); 
pu*tsOWai*tm^ -for dormed*tior /’)； 

Aav* bu-fCZ55 ]； s i c ^ jf 0 v- a dowcdW. 

while (I) { 

m*t dorme 匕 *t_d 二 addep 七 (listener—d, (s*brud 七 sodkaddv 决） # dierrt_addr, faddvcss^sizjc); 
i*(" ^dohhCfi«"t__di 二二 一 I) 

tYYorC'CarH opch secondary sockei^ Schd daia h> the dic^i 

i-f (say(dohhed*t — d) ^ 

UevhC 七 ^r\odk—P\ro*bodol ScrvcrVXhVcv-sioh I.O\\r\h^hodk| ^hodk|\r\h> w ) —I) { 

read 一 m(dorme^t 一 d, bu-f, siz^o-f(bu-f)); ^ - ^ Read daia -fvom *tV>c diorrt. 

i-f (s*bnr^aseWp('Who’s *thc\rc?^ bu-f, IZ)) 
say(dormed 七一 d, w y® u should say Who’s 七 here ?’"’)； <： 一 Clictkihj ihc usev-^s a^sy/c\rs. 

else { 

i-f (s^(coY\Y\cci^d, u OsdarV\h> u ) != - -I) { 
vcad_m(dormc6*t_d ， bu-f, siz^o-f(bu-f ))； 
i-f (s-tv*hdascdmp( u f)sday who?” ， bu^f, 10)) 
say(dohhed*t — d) U y® u should say 'Osdar who?'W,); 
else 

say^ohhCd*t_d, u Osdar silly ^ucstioh, you ^c*t a silly ar\sy/crV\h ； 0 ； 


} 


} 


dlosc(dohhcdi d)* Close i\\t scdor>da\ry sodkei v/c used -for -the doyw 忱 satiow 


vrtuvh Oj 
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test drive 



Tqst DriVq 


Now that you’ve written the knock-knock server, it’s 
time to compile it and fire it up. 

Scv-vcv- tor\solc 



File Edit Window Help I mTheServer 


> gcc ikkp_server.c -o ikkp_server 

> ./ikkp 一 server 
Waiting for connection 


The server’s waiting for a connection, so 
open a separate console and connect to it 
with telnet: 

Client ^OhSole 


File Edit Window Help IrnTheClient 


> telnet 127.0.0.1 30000 
Trying 127.0.0.1... 

Connected to localhost. 

Escape character is ' A ]'. 

Internet Knock-Knock Protocol Server 
Version 1.0 


Knock! Knock! 


> Who's there? 


Oscar 


> Oscar who? 


Oscar silly question, you get a silly answer 
Connection closed by foreign host. 


The server can tell 
you a joke, but what 
happens if you break 
the protocol and 
send back an invalid 
response? 

Clieivt dohsole 


File Edit Window Help I mTheClient 


> telnet 127.0.0.1 30000 
Trying 127.0.0.1... 

Connected to localhost. 

Escape character is ' A ]'. 

Internet Knock-Knock Protocol Server 
Version 1.0 

Knock! Knock! 

> Come in 

You should say 'Who's there?'!Connection closed by foreign host. 

> 也 " — 


The server is able to validate the data you send it and 
close the connection immediately. Once you’re done 
running the server, you can switch back to the server 
window and hit Gtrl-G to close it down neatly. It even 
sends you a farewell message: 

Scv-vcv* £.or\solc 


I File Edit Window Help I'mTheServer 


> gcc ikkp_server.c -o ikkp—server 

> ./ikkp 一 server 
Waiting for connection 
A CBye! 

> 



That’s great! The server does everything you need it to do. 


Or does it? 
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sockets and networking 


The server caw only talk to owe person at a time 

There’s a problem with the current server code. Imagine 
someone connects to it and he is a little slow with his responses: 


The sevvev is vuhhih0 
Oh a out Oh 

"the /htevhei. 


I File Edit Window Help I’mTheClient— 


> telnet knockknockster.com 30000 
Trying knockknockster.com... 
Connected to localhost. 

Escape character is ' A ]'. 

Internet Knock-Knock Protocol Server 
Version 1.0 
Knock! Knock! 

> Who's there? 

Oscar 

> 


Then, if someone else tries to get 
through to the server, she can’t; it’s busy 
with the first guy: 


File Edit Window Help I’mAnotherClient 


> telnet knockknockster.com 30000 
Trying knockknockster.com... 
Connected to localhost. 

Escape character is ' A ]'. 


The problem is that the server is still busy talking to the first 
guy. The main server socket will keep the client waiting until the 
server calls the accept () system call again. But because of the 
guy already connected, it will be some time before that happens. 






The server can’t respond to the second user, because it is busy dealing with the 
first. What have you learned that might help you deal with both clients at once? 
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different clients, different sockets 


You caw forkO a process for each client 


When the clients connect to the server, they start to have a 
conversation on a separate, newly created socket. That means the 
main server socket is free to go and find another client. So let’s do 
that. 


When a client connects, you can fork () a separate child process 
to deal with the conversation between the server and the client. 


Child - ^ 

pv-o^css 




While the client is talking to the child process, the server’s parent 
process can go connect to the next client. 



The parent and child use different sockets 

One thing to bear in mind is that the parent server process will 
only need to use the main listener socket. That’s because the 
main listener socket is the one that’s used to accept () new 
connections. On the other hand, the child process will only ever 
need to deal with the secondary socket that gets created by the 
accept () call. That means once the parent has forked the 
child, the parent can close the secondary socket and the child can 
close the main listener socket. 


-Po\rkihft the n , x 

the yaLi 二 ? ^ close (connect - d); 
^losc this socket close (listener d) 




Out -bKc cM\\d jets 
tv-catcdi, it cav\ 
tlosc *tWis socket 



_ Dumb Questions " 

If I create a new process for 
each client, what happens if hundreds 
of clients connect? Will my machine 
create hundreds of processes? 

Yes. If you think your server will get 
a lot of clients, you need to control how 
many processes you create. The child 
can signal you when it’s finished with a 
client, and you can use that to maintain a 
count of current child processes. 
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sockets and networking 


/jk^harpen your pencil 


This is a version of the server code that has been changed to 
fork a separate child process to talk to each client...except it’s 
not quite finished. See if you can figure out the missing pieces 
of code. 


while (1) { 

int connect_d = accept(listener_d, (struct sockaddr *)&client—addr, 

&address—size); 

if (connect_d — -1) 

error("Can't open secondary socket"); 


if (.) { 

close ( ); 

if (say(connect_d, 

’▼Internet Knock-Knock Protocol Server\r\nVersion 1.0\r\nKnock! Knock!\r\n> n ) 
!= - 1 ) { 

read—in(connect_d, buf, sizeof(buf)); 

if (strncasecmp("Who's there?", buf, 12)) 

say(connect_d, "You should say 'Who's there?'!"); 
else { 

if (say(connect_d, "Oscar\r\n> ’▼) != -1) { 

read—in(connect_d, buf, sizeof(buf)); 

if (strncasecmp("Oscar who?" A buf, 10)) 

say(connect_d, "You should say 'Oscar who?'!\r\n n ); 
else 

say(connect_d, "Oscar silly question, you get a silly answer\r\n n ); 


close( ); 

.^ - should -the ^ild do i\\t dov>vc\rsatiov> is doy>c? 

} 

close ( ); 
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code written 

- %|harpen your pencil_ 

< uOllltlOn This is a version of the server code that has been changed to 

fork a separate child process to talk to each client — except 
it’s not quite finished. You were to figure out the missing 
pieces of code. 

while (1) { 

int connect—d = accept(listener_d, (struct sockaddr *)&client_addr, 

&address—size); 

if (connect—d — -1) 

error("Can't open secondary socket"); 

_TKis tvca-tcs i\\t tKild pvodcss, a^d you k^oy/ i\\ai i-f 

if ( WorkO { 如 -fovkO dall \re*tu\ry\s O, you must be m AiW. 

close ( ihc ^hild, you ^ccd -fco dose ~ The 乩 ild will use o^ly i\\t 

if (say (connect d r lis-tc^cv socket so 己 ke 七 *to "talk *to dierrt. 

"Internet Knock-Knock Protocol Server\r\nVersion 1.0\r\nKnock! Knock!\r\n> ’▼) 

!= - 1 ) { 

read_in(connect—d, buf, sizeof(buf)); 

if (strncasecmp("Who's there?" f buf, 12)) 

say(connect_d, "You should say ’Who's there?*!"); 
else { 

if (say(connect_d, "Oscar\r\n> ’▼) != -1) { 

read—in(connect_d, buf, sizeof(buf)); 

if (strncasecmp("Oscar who? n , buf, 10)) 

say(connect_d, "You should say 'Oscar who?'!\r\n"); 
else 

say(connect_d, "Oscar silly question, you get a silly answer\r\n n ); 

} Ov\U the do^vc^saiio^^s over, ihc dhild 

} dose Ac sodkei -to ihc dic^rt. 

} ^ 

close ( .........)； 

. ~ Out -the dKild f^rodcss v>as -fmishcd talklWrt should Wit 
j TKa*t v/ill fv-cvcy>*t i*t -fv-om m*to 七 he mam scv-vcv- loop. 

close (.… .); 

} 
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sockets and networking 


CMD 
./ikkp 
./ikkp 


server 

server 


> ps 
PID TTY 

14324 ttys002 
14412 ttys002 

> 



Tesr DriVq 


Let’s try the modified version of the server. You can 
compile and run it in the same way: 


Scv-vcv- tohsolc 


I File Edit Window Help I’mTheServer 


If you open a separate console and start telnet, you 
can connect, just like you did before: 

CliCht 乙 OhSole 

Everything seems the same, but if you leave the client 
running with the joke half-told, you should be able to 
see what’s changed: 


I File Edit Window Help I’mTheClient 


If you open a third console, you will see that there are now two 
processes for the server: one for the parent and one for the child: 

TKc ps sV)0>WS I pile Edit Window Help I’mJustCurious 

Uh% and Cy， •…. 

The yV'oCcss 



T\\t tWild process 



That means you can connect, even while the first 
client is still talking to the server: 


I File Edit Window Help I’mAnotherClient 


Coy\so\c-^^ 

Now that you’ve built an Internet server ， 
let’s go look at what it takes to build a 
client, by writing something that can 
read from the Web. 


> telnet 127.0.0.1 30000 
Trying 127.0.0.1... 

Connected to localhost. 

Escape character is ' A ]'. 

Internet Knock-Knock Protocol Server 
Version 1.0 

Knock! Knock! 

> 


> telnet 127.0.0.1 30000 
Trying 127.0.0.1... 

Connected to localhost. 

Escape character is ' A ]'. 

Internet Knock-Knock Protocol Server 
Version 1.0 

Knock! Knock! 

> Who's there? 

Oscar 

> 


> gcc ikkp_server. c -o ikkp—server 

> ./ikkp 一 server 
Waiting for connection 


o o 
o o 


loo 

Too 


o o 


you are here ► 
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the client 


Writing a web client 


What if you want to write your own client program? Is it 
really that different from a server? To see the similarities 
and differences, you’re going to write a web client for the 
hypertext transfer protocol (HTTP). 

HTTP is a lot like the Internet knock-knock protocol you 
coded earlier. All protocols are structured conversations. Every 
time a web client and server talk, they say the same kind of 
things. Open telnet and see how to download 
http:/ / en.wikipedia.org/wiki/0 ’Reilly—Media. 

This is the 
addv-css o-P Wikipedia. 

get a slightly ^ 





Mos*t y/eb serws \rur\ cm ^ 0 . 


File Edit Window Help I’mJustCurious 


di-P-fcvcht address wheh 
you t\ry it. 

Vou r^ccd *to type 
•m *L>mo I'mcs. 

A^d thch you v\ttd b> 

hit \rctu\rh a^d leave a 
bldhk lihC. 

TV^c scv-vcv- -f iv-s-t 
vcspo\r\ds some 
details abo^-t 
web fay. 


> telnet en.wikipedia.org 80 
Trying 91.198.174.225... 

Connected to wikipedia-lb.esams.wikimedia.org. 
Escape character is ' A ]'. 

GET /wiki/O' Reilly 一 Media http/1.1 七 — TiVis is 
Host: en.wikipediaTorg *tKc Kos-t^a 



HTTP/1.0 200 OK 
Server : Apache 


iia http/1.1 — This is *tKc -follov/s 

j Kos*ty>amC m URL. 

In HTTP/I.I, you heed "fco say 
KoS' (: you av*C usih^. 


<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http : //www.w3.org/TR/xhtmll/DTD/xhtmll-transitional•dtd n > 

<html lang=en" dir= n ltr" class"client-nojs" 
xmlns="http : //www.w3.org/199 9/xhtml"> 

<head> 

<titleX)'Reilly Media - Wikipedia , the free encyclopedia</title> 

^ A^d this is the WT/V\L the web page. 


When your program connects to the web server, it will need to 

send at least three things: ^ Mosi web d—ts anally s C hd a \oi move \^o^aho^ 

but you II jus*t schd "the dmouKrt. 

A GET command 

GET /wiki/0'Reilly_Media http/1.1 

The hostname 

Host : en.wikipedia.org 

A blank line 

But before you can send any data at all to the 
server, you need to make a connection from 
the client. How do you do that? 


o 

O 

o 
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Clients are m charge 


Clients and servers communicate using sockets, but the way 
that each gets hold of a socket is a little different. You’ve 
already seen that servers use the BLAB sequence: 


o 

Bind a port. 

❺ 

Listen. 

o 

Accept a conversation. 

o 

Begin talking. 

A server spends most of its life waiting for a fresh connection 
from a client. Until a client connects, a server really can’t 
do anything. Clients don’t have that problem. A client can 
connect and start talking to a server whenever it likes. This is 
the sequence for a client: 

o 

Connect to a remote port. 

❺ 

Begin talking. 


I was taught 
never to speak 
until rm spoken to. 


O 

o 



Remote ports and IP addresses 

When a server connects to the network, it just has to decide 
which port it’s going to use. But clients need to know a little 
more: they need to know the port of the remote server, but 
they also need to know its internet protocol (IP) address: 

208.201.239.100 — Addresses v/i 七 W arc IP version \ format Mosi 

will eventually be v-cplatcd lov>5cv \/trs\oY\ addv-csscs. 

Internet addresses are kind of hard to remember, which is 
why most of the time human beings use domain names. A 
domain name is just an easier-to-remember piece of text like: 

www. oreilly. com 


Even though human beings prefer domain names, the actual 
packets of information that flow across the network only use 
the numeric IP address. 


you are here ► 


491 







client sockets 


Create a socket for aw IP address 


Once your client knows the address and port number of the 
server, it can create a client socket. Client sockets and server 

To save spate, examples 

cMtck V^crc. But *m youv always eMtcM 

-for cv-\rov-s. 

The difference between client and server code is what they do 
with sockets once they’re created. A server will bind the socket to 
a local port, but a client will connect the socket to a remote port 


sockets are created the same way: 

int s = socket (PF INET, SOCK STREAM, 0) ; 


These I'rnes 

a socket 

addv-css -Pov- 

zoe.zoiii^ioo 

OY\ pov-t QO. 


struct sockaddr 一 in si; 
memset(&si, 0, sizeof(si)); 
si•sin 一 family = PF_INET; 
si.sin_addr.s_addr = inet_addr("208.201.239.100") 
si . sin_j>ort = htons (80); 

connect(s, (struct sockaddr *) &si, sizeof(si)); 




Clicht 



?ori eo 



TW\s I'mc 

sodkc*t *to 
y-cmo*tc for 七 . 




Scv-vcr ro^xo\xv\\oo 
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Hello? I doiVt want 
to know how to connect a 
socket to an IP address. 
Tm actually human .I 
want to connect to a real 
domain name. 


The above code works only for 
numeric IP addresses. 

To connect a socket to a remote domain name, 
you’ll need a function called getaddrinf o (). 
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sockets and networking 


getaddrmfoH gets addresses for domains 


The domain name system is a huge address book. It’s a way of 
converting a domain name like www.oreilly.com into the kinds 
of numeric IP addresses that computers need to address the 
packets of information they send across the network. 

Create a socket fora domain name 

Most of the time, you’ll want your client code to use the DNS 
system to create sockets. That way, your users won’t have to 
look up the IP addresses themselves. To use DNS, you need to 
construct your client sockets in a slightly different way: 


The PKS is a address book. 



Domain name 

Address | 

en.wikipedia.org 

91.198.174.SS5 

www.oreilly.com 

S08.S01.S39.100 

www.oreilly.com 

208.S01.239.101 


Some lavjc sites V^avc 
scvcv-al IP addresses. 


Computcirs heed IP 
add\rcsscs "to dveate 
^ctwovk packets. 


#include <ne tdb .h > 《 


struct addrinfo *res; 


struct addrinfo hints; 


This dire 注 tes a 
妁 \rcsou\rdC 
-Pom povt oh 
www.oircilly.dom. 


memset(&hints , 0, sizeof(hints)); 
hints•ai 一 family = PF_UNSPEC; 
hints . ai_socktype = SOCK—STREAM; 
getaddrinf o ("www. oreilly. com" , "80 ", 


^c*taddv-'m-foO 
h\t fov 七 *to be a 

&hints, &res); 


The getaddrinf o () constructs a new data structure on the 
heap called a naming resource. The naming resource represents 
a port on a server with a given domain name. Hidden away 
inside the naming resource is the IP address that the computer 
will need. Sometimes very large domains can have several IP 
addresses, but the code here will simply pick one of them. You 
can then use the naming resource to create a socket. 

int s = socket(res->ai family. 


Wow you dv-catc ihc sodket 
us,h 9 hamiir^ \rcsouv-^c. 




res->ai socktype. 


res->ai 一 protocol); 


Finally, you can connect to the remote socket. Because the 
naming resource was created on the heap, you’ll need to tidy it 
away with a function called f reeaddrinf o () : 


vcs->a*i_addiv-lcir\ is site 
addv-css *m memov-y. 


rcs->ai add\r is the-^^connect (s, res->ai_addr , res 

vcirwotc freeaddrinfo (res) ; ^ — 
host a^d pov~ 七 . 、 

Once you’ve connected a socket to a remote port, you can 
read and write to it using the same reev () and send () 
functions you used for the server. That means you should have 
enough information now to write a web client... 


->ai_addrlen) ; """"" h> 

~~ 七 he V-Crwo-tc socket 

jVkh you’ve vou delete 

七 he addvess daia with -hrccaddv-ih-foO. 
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magnets muddled 


Code Magnets 


Here is the code for a web client that will download the contents of a page from Wikipedia 
and display it on the screen. The web page will be passed as an argument to the program. 
Think carefully about the data you need to send to a web server running HTTP. 



#include 

#include 

#include 

#include 

#include 

#include 

#include 

#include 


<stdio.h> 
<string.h> 
<errno.h> 
<stdlib.h> 
<sys/socket.h> 
<arpa/inet.h> 
<unistd.h> 
<netdb.h> 


void error(char *msg) 

{ 

fprintf(stderr, n %s: %s\n n , msg, strerror (errno)); 
exit (1); 

} 

int open_socket(char *host, char *port) 

{ 

struct addrinfo *res; 

struct addrinfo hints; 

memset(&hints, 0, sizeof(hints)); 

hints.ai_family = PF—UNSPEC; 

hints.ai_socktype = SOCK—STREAM; 

if (getaddrinfo(host, port, &hints, &res) == -1) 
error("Can't resolve the address"); 
int d—sock = socket(res->ai—family, res->ai—socktype, 

res->ai—protocol); 

if (d—sock — -1) 

error ("Can't open socket"); 

int c = connect(d—sock, res->ai_addr, res->ai_addrlen); 
freeaddrinfo (res); 
if (c — -1) 

error("Can't connect to socket"); 
return d sock; 
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int say(int socket, char *s) 

{ 

int result = send(socket, s, strlen(s), 0); 
if (result — -1) 

fprintf(stderr f n %s: %s\n n , "Error talking to the server ", 
strerror(errno)); 

return result; 

} 

int main(int argc, char *argv[]) 

{ 

int d_sock; 

d_sock = ; 

char buf[255]; 

sprintf(buf, , argv[1]); 

say(d_sock, buf); 

say(d_sock, ); 

char rec[256]; 

int bytesRcvd = recv(d—sock, rec, 255, 0); 
while (bytesRcvd) { 
if (bytesRcvd — -1) 

error("Can't read from server ”）； 

rec[bytesRcvd]= ; 

printf ("%s n , rec); 

bytesRcvd = recv(d sock, rec, 255, 0); 


return 0; 


















magnets unmuddled 


Code Magnets Solution 


Here is the code for a web client that will download the contents of a page from Wikipedia 
and display it on the screen. The web page will be passed as an argument to the program. 
You were to think carefully about the data you need to send to a web server running HTTP. 



#include 

#include 

#include 

#include 

#include 

#include 

#include 

#include 


<stdio.h> 
<string.h> 
<errno.h> 
<stdlib.h> 
<sys/socket.h> 
<arpa/inet.h> 
<unistd.h> 
<netdb.h> 


void error(char *msg) 

{ 

fprintf(stderr, n %s: %s\n n , msg, strerror (errno)); 
exit (1); 


int open_socket(char *host, char *port) 

{ 

struct addrinfo *res; 

struct addrinfo hints; 

memset(&hints, 0, sizeof(hints)); 

hints.ai_family = PF—UNSPEC; 

hints.ai_socktype = SOCK—STREAM; 

if (getaddrinfo(host, port, &hints, &res) == -1) 
error("Can't resolve the address"); 
int d—sock = socket(res->ai—family, res->ai—socktype, 

res->ai—protocol); 

if (d—sock — -1) 

error ("Can't open socket"); 

int c = connect(d—sock, res->ai_addr, res->ai_addrlen); 
freeaddrinfo (res); 
if (c — -1) 

error("Can't connect to socket"); 
return d sock; 
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int say(int socket, char *s) 

{ 

int result = send(socket, s, strlen(s), 0); 
if (result — -1) 

fprintf(stderr f n %s: %s\n n , "Error talking to the server ", 
strerror(errno)); 

return result; 

} 

int main(int argc, char *argv[]) 

{ 

int d sock; 


d sock = 


char buf[zco 」 ； 



rwa 七 c a s,br\ 




GET /wiki/%s http/1.l\r\n" 



sprintf(buf A 


, argv[l]); 


say(d sock, buf); 


say(d_sock, 
char rec[256]; 

int bytesRcvd = recv(d_sock, rec, 255, 0); 
while (bytesRcvd) { 



if (bytesRcvd — -1) 


error ("Can ' t read from server’ 1 ); 



/\dd a Vy *to 如“。 


Add a 



printf ( n %s n , rec); 

bytesRcvd = recv(d sock, rec, 255, 0); 


close(d 一 sock) 


return 0; 


n \r\ n ” 


Host: en.wikipedia.org\r\ 
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test drive 



Tesr DriVq 


If you compile and run the web client, you make it 
download a page from Wikipedia like this: 

You’ll Kavc *to v-cfladc ay>y spades Vrtii dhav-ad*tc\rs. 

File Edit Window Help I’mTheWebClient 


> gcc wiki_client.c -o wiki—client 

> •/wiki 一 client "O' Reilly_Media" 

HTTP/1.0 一 200 OK 一 

Date: Fri, 06 Jan 2012 20:30:15 GMT 
Server : Apache 

• •參 

Connection : close 
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 

"http : //www.w3.org/TR/xhtmll/DTD/xhtmll-transitional.dtd"> 

<html lang= n en" dir="ltr" class="client-nojs" xmlns="http : //www.w3.org/1999/xhtml"> 
<head> 

<titleX)'Reilly Media - Wikipedia t the free encyclopedia</title> 

<meta http-equiv="Content-Type" content="text/html; charset=UTF-8" /> 

… 个 

Thch you get the dohlchts o-P the web page ^ Wikipedia. 



M 七 he you II jet the vespo^sc HEADERS. These 

■tell you ih'mjs aboui ihc sevveir ihc web page. 


It works! 

The client took the name of the page from the 
command line and then connected to Wikipedia to 
download the page. Because it’s constructing the path 
to the file, you need to make sure that the you replace 
any spaces in the page name with underscore (_) 
characters. 



feog piste 


Why not update the code to automatically replace characters like spaces for 
you? For more details on how to replace characters for web addresses, see: 

http://www. w3schools. com/tags/ref 一 urlencode.asp 
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Dumb Quest! 


9ns 


Should I create sockets with IP addresses or domain names? 

Most of the time, you'll want to use domain names. They’re easier to remember, and 
occasionally some servers will change their numeric addresses but keep the same domain 
names. 

So, do I even need to know how to connect to a numeric address? 

Yes. If the server you are connecting to is not registered in the domain name system, 
such as machines on your home network, then you will need to know how to connect by IP. 

Can I use getaddrinfo () with a numeric address? 

Yes, you can. But if you know that the address you are using is a numeric IP, the first 
version of the client socket code is simpler. 


BULLET POINTS —— 

■ A protocol is a structured 
conversation. 

■ Servers connect to local ports. 

■ Clients connect to remote ports. 

■ Clients and servers both use sockets 
to communicate. 


■ You write data to a socket with 

send(). 

■ You read data from a socket with 

recv(). 

■ HTTP is the protocol used on the 
Web. 
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c toolbox 



Your C Toolbox 


You’ve got Chapter 11 under 
your belt，and now you’ve 
added sockets and networking 
to your toolbox. For a complete list 
of tooltips in the book, see Appendix ii. 




Crtdiit 
s <>ckcis wi-th 
仏 e sodkc-tO 
-Puhd*tioh. 


Servers BLAB: 

B 二 bihdO 

L- — listchO 
A - autyiO 
B 二 Bcgih 


Use -forkO 
■bo to\t WrbV> 
several d\ty\b> 
at oy>6c- 



system 


y taAA 一 W) 

^'mA s 

a dA 代 sscs W 


^o^ XTi ' 
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12 threads 



Programs often need to do several things at the same time. 

POSIX threads can make your code more responsive by spinning off several pieces of 
code to run in parallel. But be careful! Threads are powerful tools, but you don’t want 
them crashing into each other. In this chapter, you’ll learn how to put up traffic signs and 
lane markers that will prevent a code pileup. By the end, you will know how to create 
POSIX threads and how to use synchronization mechanisms to protect the integrity 
of sensitive data. 


this is a new chapter 
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working in parallel 


Tasks are sequential … or wot 


Imagine you are writing something complex like a game in 
C. The code will need to perform several different tasks: 


It will need to update 
ike ^r^liics on die 


screen. 


It will need to read 
control infomation 
froin games 
controller or 
\eyboM. 



It will need to 
calculate die latest 
locations of die 
objects tiiat are 
moving in tire gauie. 


It mi^lrt need 
to co 顺 unieate 
wilklke disl 
and ^ie network- 


Not only will your code need to do all of these things, but it 
will need to do them all at the same time. That’s going 
to be true for many different programs. Ghat programs 
will need to read text from the network and send data to 
the network at the same time. Media players will need to 
stream video to the display as well as watch for input from 
the user controls. 


How can your code perform several 
different tasks at once? 
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..and processes are wot always the answer 

You’ve already learned how to make the computer do 
several things at once: with processes. In the last chapter, 
you built a network server that could deal with several 
different clients at once. Each time a new user connected, 
the server created a new process to handle the new session. 

Does that mean that whenever you want to do several 
things at once, you should just create a separate process? 

Well, not really, and here’s why. 


Processes take time to create 

Some machines take a little while to create new processes. Not much time, but 
some. If the extra task you want to perform takes just a few hundredths of a 
second, creating a process each time won’t be very efficient. 

Processes can’t share data easily 

When you create a child process, it automatically has a complete copy of all 
the data from the parent process. But it’s a copy of the data. If the child needs 
to send data back to the parent, then you need something like a pipe to do that 

for you. 

Processes are just plain difficult 

You need to create a chunk of code to generate processes, and that can make 
your programs long and messy. 


You need something that starts a separate task quickly, can 
share all of your current data, and won’t need a huge 
amount of code to build. 


You need threads. 


you are here ► 
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single threads of execution 


Simple processes do one thing at a time 

Say you have a task list with a set of things that you need to do: 





^>hop-n-^ ur ^ 

Cun ihe cash re^j Ster> 

^-tocK -the shop. 

^eu)ax ihe surfboards. 

Answer ihe phones. 

Fix -the roo-t. 

-the booKs. 


• ^_ ♦ AI*tcv-r\a*t»vclY> 

jus*t 50 suv-f'mj. 


You can’t do all of the tasks at the same time, not by 
yourself. If someone comes into the shop, you’ll need to 
stop stocking the shelves. If it looks like rain, you might 
stop bookkeeping and get on the roof. If you work in a 
shop alone, you’re like a simple process: you do one thing 
after another, but always one thing at a time. Sure, you can 
switch between tasks to keep everything going, but what 
if there’s a blocking operation? What if you’re serving 
someone at the checkout and the phone rings? 

All of the programs you’ve written so far have had a single 
thread of execution. It’s like there’s only been one 
person working inside the program’s process. 



0 



Pv-odcss. 
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In the same way that several people can work in the same 
shop, you can have several threads living inside the same 
process. All of the threads will have access to the same piece 
of heap memory. They will all be able to read and write to 
the same files and talk on the same network sockets. If one 


Employ extra staff: use threads 


A multithreaded program is like a shop with several 
people working in it. If one person is running the checkout, 
another is filling the shelves, and someone else is waxing the 
surfboards, then everybody can work without interruptions. 
If one person answers the phone, it won’t stop the other 
people in the shop. 

/•P you employ moire 
people, rnov-c ihdh 
thihg cav\ be 
Aoy\t at oh 匕 e. 


thread changes a global variable, all of the other threads will 
see the change immediately. 


That means you can give each thread a separate task and 
they’ll all be performed at the same time. 


Vo[A dah \TUh eadk task 

•mside a separate thread. ' 一 > > 






tr ^ ° hC thvead has io waii 

the oth 饮 th^ads 

keep V-uhhihJ. 


All o^c *tWeads 匕 a” 
vu 灼 mside a s'm^lc fvotess. 
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creating threads 


How do you create threads? 


There are a few thread libraries, and you’re going to use one of 
the most popular: the POSIX thread library, or pthread. 

You can use the pthread library on Gygwin, Linux, and the 
Mac. 


Let’s say you want to run these two functions in separate threads: 

t/T 



-to have a 
vctuvh "type. 


usc-ful 

*to vc*tu\rr\> so 
*\us*t use NULL- 


void* does—too(void 

int i = 0; 
for (i = 0; i < 5; 
sleep (1); 

puts ("Does too!"); 

} 

return NULL 



Did you notice that both functions return a void pointer? 
Remember, a void pointer can be used to point to any piece of 
data in memory, and you’ll need to make sure that your thread 
functions have a void* return type. 

You’re going to run each of these functions inside its own thread. 



Main program 


void* does not(void *a) 



void* does too(void *a) 



You’ll need to run both of these functions in parallel in separate 
threads. Let’s see how to do that. 
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Create threads with pthread_crcate 


To run these functions, you’ll need a little setup code, like some headers 
and maybe an error () function that you can call if there’s a problem. 


#include 

#include 

#include 

#include 

#include 

#include 


<stdio.h> 
<stdlib.h> 
<string.h> 
<unistd.h> 
<errno.h> 


These ave tiie iicadcv-s -fov i\\t 州 a’m part J todt- 


<pthread. h> 一 _s the hcadcv -Po\r ihc pth ⑹ d libvavy. 


void error (char *msg) 

{ 

fprintf (stderr f f, %s : %s\n f, , msg, strerror (errno)); 
exit(1); 


But then you can start the code for your main function. You’re going 
to create two threads, and each one needs to have its info stored in a 
pthread_t data structure. Then you can create and run a thread with 


pthread create(). 


〆 


This vcdovds dll abou 七七 he "thread- 


This 

the 

thv-cad- 


pthread_t tO; does—ho 七 is ihe o( ihc -Pui^diio^ ihc ihv-cad will 

pthread_t tl; 

if (pthread_create (&t0 , NULL, does—not, NULL) == -1 ) ^ Aly/avs tiicdk 

error ( "Can't create thread 10 n ); 

if (pthread create(Stl^ NULL, does too, NULL) == -1) 

error("Can't create thread tl"); 


Always 
-fov cvvovs. 


f*bl is -tKc addvess o-f 

data stvutWc ^ill st>vc 
七 he -tiivcad m-fo. 


That code will run your two functions in separate threads. But you’ve not 
quite finished yet. If your program just ran this and then finished, the 
threads would be killed when the program ended. So you need to wait for 
your threads to finish: 

The Void vcWr^cd ^ro 你 cath will be sWcd heve. 

void* result 


if (pthread 一 join(tO, Sresult)== 

error("Can't join thread 10 n ); 

if (pthread 一 join(tl, Sresult)== 

error("Can▼t join thread tl"); 


- 1 ) 


- 1 ) 


y/ai*U (or d *tWcad *to 


The pthread_j oin () also receives the return value of your thread 
function and stores it in a void pointer variable. Once both threads have 
finished, your program can exit smoothly. 


Let’s see if it works. 
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test drive 



Tqst DriVQ 


Because you’re using the pthread library, you’ll need 
to make sure you link it when you compile your program, 
like this: 


This will lihk the 
pthv-cad libv-av-y. 


I File Edit Window Help Don’tLoseTheThread 



> gcc argument.c -lpthread -o argument 


TVis is youv pvoyam. 


When you run the code, you’ll see both functions running 
at the same time: 


W\\tY\ you v*ur> Code, 

dome ou*t m d 
■ ⑶七 ovdev- 七 his. 


IFile Edit 

Window Help Don’tLoseTheThread 

> ./argument 

Does 

too! 

Does 

not! 

Does 

too! 

Does 

not! 

Does 

too! 

Does 

not! 

Does 

too! 

Does 

not! 

Does 

not! 

Does 

too! 

> 



tWeiare no o 

Dumb Questi9ns 


If both functions are running at the same time, why 
don’t the letters in the messages get mixed up? Each 
message is on its own line. 

That’s because of the way the Standard Output works. The 
text from puts () will all get output at once. 


I removed the sleep () function, and the output 
showed all the output from one function and then all the 
output from the other function. Why is that? 

Most machines will run the code so quickly that without the 
sleep () call, the first function will finish before the second 
thread starts running. 
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® eer Magnets 


It's time for a really BIG party. This code runs 20 threads that count the 
number of beers down from 2,000,000. See if you can spot the missing 
code, and if you get the answer right, celebrate by cracking open a 
couple of cold ones yourself. 


int beers = 2000000; 
void* drink lots(void *a) 


•m Wrth 2- million bccv*s. 


氏 will \ruh "tliis 


int 


for (i = 0; i < 100000; i++) { 

beers = beers - 1; Wl || ^edude the 

} bccv-s vaviable by 100 , 000 . 

return NULL; 


int main() 

{ 

pthread_t threads[20]; 
int t ; 

printf("%i bottles of beer on the wall\n%i bottles of beer\n ", beers, beers); 

for (t = 0 ； t < 20 ； t++) { ^ — >/ 咖 ’11 ⑽ ZO threads To save spate, -this example skips 

七 ha 七 r ⑽七 he Wtior>. lesimj (or cv-^s, bul do^i you 

侃 ’ - . 


do 


, NULL, 


,NULL) 


void* result; 

for (t = 0; t < 20; t++) 


y .TWis code Y/a'i-b all 

(threads [t] , ^result) ; ^ c ads *bo Vm'isii. 


printf("There are now %i bottles of beer on the wall\n n , beers); 
return 0; 



















beer solved 


Beer Magnets Solution 


It's time for a really BIG party. This code runs 20 threads that count the 
number of beers down from 2,000,000. You were to spot the missing 
code. 


int beers = 2000000; 
void* drink_lots(void *a) 

{ 

int i ; 

for (i = 0; i < 100000; i++) 
beers = beers - 1; 


return NULL 


int main() 

{ 

pthread_t threads[20]; 
int t ; 

printf("%i bottles of beer on the wall\n%i bottles of beer\n ", beers, beers); 
for (t = 0; t < 20; t++) { 



&threads ftJ 


,NULL, 


s ave spate, skipped 
P \r cv-\ro\rs—bui do^i you do ihai/ 

rink lots — k , NULL) ; 


void* result; 

for (t = 0; t < 20; t++) 



(threads[t], &result); 


printf("There are now %i bottles of beer on the wall\n n , beers); 
return 0; 


threads 
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Tqst DriVq 


Let’s take a closer look at that last program. If you compile 
and run the code a few times, this happens: 


The ZO treads have v-cdu^cd — ^ 
the bcc\rs vav-iablc -to O. 


Y/Sh 七 … 



f … 

T\\t 


File Edit Window Help Don'tLoseTheThread 


> ./beer 

2000000 bottles of beer on the wall 
2000000 bottles of beer 

There are now 0 bottles of beer on the wall 

> ./beer 

2000000 bottles of beer on the wall 
2000000 bottles of beer 

There are now 883988 bottles of beer on the wall 

> ./beer 

2000000 bottles of beer on the wall 
2000000 bottles of beer 

There are now 945170 bottles of beer on the wall 

> 


The code usually doesn’t reduce the beers 
variable to zero. 


That’s really odd. The beers variable begins with a value 
of 2 million. Then 20 threads each try to reduce the value 
by 100,000. Shouldn’t that mean that the beers variable 
always goes to zero? 





Look carefully at the code again, and try to imagine what will happen if several 
threads are running it at the same time. Why is the result unpredictable? Why 
doesn’t the beers variable get set to zero when all the threads have run? Write 
your answer below. 
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not thread-safe 


The code is wot thread-safe 


The great thing about threads is that lots of different tasks can run at 
the same time and have access to the same data. The downside is that 
all those different threads have access to the same data … 

Unlike the first program, the threads in the second program are all 
reading and changing a shared piece of memory: the beers variable. 
To understand what’s going on, let’s see what happens if two threads 
try to reduce the value of beers using this line of code: 


beers 


beers - 1 



*t>wo -thveads avc vuymiM *tKis 
|*mc CoAt a*t same 七 ime. 


o First of all, both threads will need to read the current value of the beers variable 


7~Kv*c3d / _ — ^ 




TWad 2 - 


❺ Then, each thread will subtract 1 from the number. 


Thread 




beers-i 



Thv-cad 2- 


Both tli\rc3ds avc 
"the vdluc. you 


o 


see this is ^oih^? 

Finally, each thread stores the value for beers-1 back into the beers variable. 

桑 






beers 
二 3(o 


beers 
二 3(o 


Even though both of the threads were trying to reduce the value of 
beers by 1, they didn’t succeed. Instead of reducing the value by 
2, they only decreased it by 1. That’s why the beers variable didn’t 
get reduced to zero — the threads kept getting in the way of each 
other. 

And why was the result so unpredictable? Because the threads didn’t 
always run the line of code at exactly the same time. Sometimes the 
threads didn’t crash into each other, and sometimes they did. 



TV^vcad 2- 


Be careful to look 
out for code that 
isn’t thread-safe. 

How will you know? 
Usually, if two threads 
read and write to the same variable, 
it’s not 


Watch it! 
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You need to add traffic signals 

Multithreaded programs can be powerful, but they can also 
behave in unpredictable ways, unless you put some controls 
in place. 

Imagine two cars want to pass down the same narrow 
stretch of road. To prevent an accident, you can add traffic 
signals. Those traffic signals prevent the cars from getting 
access to a shared resource (the road) at the same time. 

It’s the same thing when you want two or more threads 
to access a shared data resource: you need to add traffic 
signals so that no two threads can read the data and write it 
back at the same time. 




乙扣 s 

■Uo treads. They both 

aucss ihe same 

sh 扣 ed v^Hdble. 


Shared 

variable 


TV^c 七⑸似 s ， a ' s 七七 ^ ^ 

iWtads addessm^ same 

Lved va^akle at sa^e t-e. 


The traffic signals that prevent threads from crashing into 
each other are called mutexes, and they are one of the 
simplest ways of making your code thread-safe. 


Mu*tc%cs av-c sometimes jus 七 
tailed \ocks. 


MUT-EX = 
MUTually 

EXclusive. 
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mutex 


Use a mutex as a traffic signal 

To protect a section of code, you will need to create a mutex 
lock like this: 

pthread_mutex_t a_lock = PTHREAD_MUTEX_INITIALIZER; 


The mutex needs to be visible to all of the threads that might 
crash into each other, so that means you’ll probably want to 
create it as a global variable. 


PTHREAD MUTEX INITIAL 工 ZER is actually a macro. 
When the compiler sees that, it will insert all of the code your 
program needs to create the mutex lock properly. 



Red means stop. 

At the beginning of your sensitive code section, you need to place your first 
traffic signal. The pthread—mutex—lock () will let only one thread 
get past. All the other threads will have to wait when they get to it. 






pthread 一 mutex 一 lock(&a_lock); 

/* Sensitive code starts here... */ 


Or^ly ov\t -tKvcad at a time v/ill past 



Green means go. 

When the thread gets to the end of the sensitive code, it makes a call 
to pthread_mutex_unlock () . That sets the traffic signal back to 
green, and another thread is allowed onto the sensitive code: 



/* ...End of sensitive code */ 

pthread 一 mutex 一 unlock(&a_lock); 


Now that you know how to create locks in your code, you have 
a lot of control over exactly how your threads will work. 
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Passing L^ng Values fa Thread 峨祕讲 Cl^se 


Thread functions can accept a single void pointer parameter and return 
a single void pointer value. Quite often, you will want to pass and 
return integer values to a thread, and one trick is to use long values, 
longs can be stored in void pointers because they are the same size. 



void* do stuff(void* param) 


A iWtad act^i a 

void pom*tcv" 

long thread 一 no = (long) param;^- - Co^vc\rt i*t badk b> B long. 

printf("Thread number %ld\n n , thread_no); 

return (void*) (thread—no + 1); ^♦ Cast i-t batk bo a void po'm-tcv 

y^i\\tY\ iVs ve 七 u\ry\ed. 


int main() 

{ 

pthread—t threads[20]; 
long t; 

for (t = 0; t < 3; t++) { 

pthread—create(^threads[t ], 

} 

void* result; 

for (t = 0; t < 3; t++) { 

pthread—join(threads[t], &result); 
printf("Thread %ld returned %ld\n n 

} 

return 0; 


Coir>vc\rt 七 he \ov\^ i value 
"to B void po’nvtev-. 

NULL, do stuff, 


)t); 


t. 


Convert vc*tuv^ value *to a 
|or\^ bc-fovc usm^ i*t- 

(lon< 


.g) result); 


I File Edit Window Help Don’tLoseTheThread 



Bsdh -thvccld vcdcivcs i-ts 
thv-cad humbe\r. 

tadii *tWcad \rc*tu\r^s its 
■tWcad ^ur^bev- + I- 


1 2 3 
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ExeRciSe 


There’s no simple way to decide where to put the locks in your code. Where you put them will 
change the way the code performs. Here are two versions of the drink—lots () function 
that lock the code in different ways. 


Version A 



Version P 
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JDOtties 




or neer on rne wail 




Both pieces of code use a mutex to protect the beers variable, and each now displays the value of beers before 
they exit, but because they are locking the code in different places, they generate different output on the screen. 

Can you figure out which version produced each of these two runs? 


File Edit Window Help Don’tLoseTheThread 


MaieM todt 

七 he 七 . 



s s o 
dee 

©112 w 
X t t 8 O 

i t t o 3 4 2 n 
f o 03200657652861160854 
5^61119766665554332110 e 

e o o || || = || || = || || || || 1=1 || || = = || I- || || a 

e o o 

b.oosssssssssssssssssssse 
/oorrrrrrrrrrrrrrrrrrrrr 
• ooeeeeeeeeeeeeeeeeeeeee 
ooeeeeeeeeeeeeeeeeeeee^ 
>22bbbbbbbbbbbbbbbbbbbbT> 








exercise so/vec/ 



ExegciSe 

§OLutlON 


There’s no simple way to decide where to put the locks in your code. Where you put them will 
change the way the code performs. Here are two versions of the drink—lots () function 
that lock the code in different ways. 


Version A 



Version P 



518 Chapter 12 









threads 




bottles 




of beer on the wall 




Both pieces of code use a mutex to protect the beers variable, and each now displays the value of beers before 
they exit, but because they are locking the code in different places, they generate different output on the screen. 

You were to figure out which version produced each of these two runs. 


File Edit Window Help Don’tLoseTheThread 


MaieM todt 

七 he 七 . 
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congratulations! 


Congratulations! You’ve (almost) 
reached die endoPAe book. Now it’s 
time to oracle open one of those 
2,000,000 bottles of beer and celebrate! 

You’re now in a great position to decide what kind of G coder you 
want to be. Do you want to be a Linux hacker using pure G? Or 
a maker writing embedded G in small devices like the Arduino? 
Maybe you want to go on to be a games developer in C++? Or a Mac 

and iOS programmer in Objective-G? 



Whatever you choose to do, you’re now part of the community that uses and loves 
the language that has created more software than any other. The language behind the 
Internet and almost every operating system. The language that’s used to write almost 
all the other languages. And the language that can write for almost every processor in 
existence, from watches and phones to planes and satellites. 


New C Hacker，we salute you! 


thereicire no o 

Dumb Questi9ns 


Does my machine have to 
have multiple processors to support 
threads? 

No. Most machines have processors 
with multiple cores, which means that 
their CPUs contain miniprocessors that 
can do several things at once. But even 
if your code is running on a single core/ 
single processor, you will still be able to 
run threads. 

How? 

The operating system will switch 
rapidly between the threads and make it 
appear that it is running several things at 
once. 


Will threads make my programs 
faster? 

Not necessarily. While threads can 
help you use more of the processors and 
cores on your machine, you need to be 
careful about the amount of locking your 
code needs to do. If your threads are 
locked too often, your code may run as 
slowly as single-threaded code. 

How can I design my thread code 
to be fast? 

Try to reduce the amount of data 
that threads need to access. If threads 
don’t access a lot of shared data, they 
won’t need to lock each other out so often 
and will be much more efficient. 


Are threads faster than separate 
processes? 

They usually are, simply because 
it takes a little more time to create 
processes than it does to create extra 
threads. 

l，ve heard that mutexes can lead 
to “deadlocks.” What are they? 

Say you have two threads, and they 
both want to get mutexes A and B. If the 
first thread already has A, and the second 
thread already has B, then the threads will 
be deadlocked. This is because the first 
thread can’t get mutex B and the second 
thread can’t get mutex A. They both come 
to a standstill. 
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Your C Toolbox 


You’ve got Chapter 12 under 
your belt，and now you’ve 
added threads to your toolbox. 
For a complete list of tooltips in the 
book, see Appendix ii. 


■otcsscs 


Y •… 汰 a 


P 0 S|)< threads 

^p*thv*cad) is 

a -threadm^ 
library. 


Threads allow 
3 p^rodess *to do 
r^o\TC *thah OhC 

七 h’mg a 七七 he 
same time. 


丁 Wreads ave 

种 W ' 外 

^vo6csscs. 


p-thrcad^rca-tcO 
Creates a thread 

*bo vuh a -fuhd*tioh. 


otWead \o-0 

a tWcaA tP 


m 


;、sVv 


Threads 
shav-c 七 he 
sanr»c global 
variables. 


# "two ihiTCcids 

广扣 d upd 如 
如 sar^e 

y° u,r will be ； 

u ^P^di^blc. 


Mu*tc%es arc 
lodks that 

pro 七 ed 七 shared 
dd*Ld. 


▽ 七 Wread 一 汰 (） 

creates a mu^ or. code. 


p 七 hread—mu 七 ex—uh lodkO 

v-clcascs the mu*tc 乂 . 
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CLab3 

Blasteroids 

This lab gives you a spec that describes a program 
for you to build, using the knowledge you’ve gained 
over the last few chapters. 

This project is bigger than the ones you’ve seen so far. 
So read, the whole thing before you get started, and 
give yourself a little time. And don’t worry if you get 
stuck ； there are no new C concepts in here, so you 
can move on in the book and come back to the lab 
later. 

We’ve filled, in a few design details for you, and. we’ve 
made sure you’ve got all the pieces you need to write 
the code. 



It’s up to you to finish the job ， but we won’t give you 
the code for the answer. 


Write the arcade game Plasteroids 

Of course, one of the real reasons people want to learn G is so 
they can write games. In this lab, you’re going to pay tribute to 
one of the most popular and long-lived video games of them all. 

It’s time to write Blasteroidsl 


TV\\s \s y 。 吖 st 0 代 . 


These avc the humbev* of 
liv« you have /ou lose 
a ^ you get hit by 
astcvoid. IVhch you \ruh out o-P 
I— it’s game ovcv-. 


TV)*is IS youv- s^atcsWif. Use 
youv- keyboavd *to -fly y^uv- 
spadesWif, 3"t 3s*tcv-oids 

y/Wile dvoidm^ Wrt. 



Poy/f Poy/f Vo u 
s\\ooi as-tcv-oids by 

build 


TV^csc avc asWo'ids you 
V^avc *to A 。。 七 . 七 
? om*b *fov caA as 七一 


you 


shoo 七 . 
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Your mission: blast the asteroids without getting hit 


Sinister. Hollow. And all strangely similar. The asteroids are the 
bad guys in this game. They float and rotate slowly across the 
screen, promising instant death to any passing space traveler who 
happens to meet them. 




Welcome to the starship Vectorize'. This is the ship that you will 
fly around the screen using your keyboard. It’s armed with a 
cannon that can fire at passing asteroids. 


If an asteroid is hit by a blast from the spaceship’s cannon, it 
immediately splits into two, and the player’s score increases by 
100 points. Once an asteroid has been hit a couple of times, it’s 
removed from the screen. 




If the ship gets hit by an asteroid, you lose a life. You have three 
lives, and when you lose the last one, that’s the end of the game. 


AAA 


Blasteroids 


Allegro 

Allegro is an open source game development library that allows 
you to create, compile, and run game code across different 
operating systems. It works with Windows, Linux, Mac OS, and 
even phones. 

Allegro is pretty straightforward to use, but just because it’s a 
simple library doesn’t mean it lacks power. Allegro can deal 
with sound, graphics, animation, device handling, and even 3D 

graphics if your machine supports OpenGL.^- 八,、 , . 

6 F y F Opc^L is ^ sta^davd (or 

yaphids p\rodcsso\rs. You describe 
you\r ZD objects -to Oyc^L, ar>d ii 
handles (mos 七 ） o*P 七 he rwa-th -fov- you. 

Installing Allegro 

You can get the source for Allegro over at the Allegro 

SourceForge website: 丁 ^ ^ u pda*tcd move o(itv\ *tV ^ 於 

books, so tWis URL rn 吵七 be 

http:/ / alleg.sourceforge.net/ x oy\ your -favov-*i*tc seavA 


You can download, build, and install the latest code from the 
source repository. There are instructions on the site that will tell 
you exactly how to do that for your operating system. 


You may need CMake 

When you build the code, you will probably also need to install 
an extra tool called CMake. CMake is a build tool that makes it 
a little easier to build G programs on different operating systems. 
If you need CMake, you will find all you need over at 
http:/ / www. cmake. org. 



The code 
we’ve 
supplied 
in this lab 
is for 


version 5 of Allegro. 


If you download and 
install a newer version, 
you may need to make a 
few changes. 
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What does Allegro do for you? 


The Allegro library deals with several things: 


O 如乜 

Allegro will create a simple window to contain your game. This might not 
seem like a big deal, but different operating systems have very different ways 
of creating windows and then allowing them to interact with the keyboard 
and the mouse. 



Events 

Whenever you hit a key, move a mouse, or click on something, your system 
generates an event. An event is just a piece of data that says what happened. 
Events are usually put onto queues and then sent to applications. Allegro 
makes it simple to respond to events so that you can easily, say, write code 
that will run if a user fires her canyon by hitting the spacebar. 



Timers 

You’ve already looked at timers at the system level. Allegro provides a 
straightforward way to give your game a heartbeat. All games have some 
sort of heartbeat that runs so many times a second to make sure the game 
display is continuously updated. Using a timer, you can create a game that, 
for example, displays a fresh version of the screen at 60 frames per second 
(FPS). 



Graphics buffering 

To make your game run smoothly, Allegro uses double buffering. Double 
buffering is a game-development technique that allows you to draw all 
of your graphics in an offscreen buffer before displaying it on the screen. 
Because an entire frame of animation is displayed all at once, your game will 
run much more smoothly. 



Graphics and transformations 

Allegro comes with a set of built-in graphics primitives that allow you 
to draw lines, curves, text, solids, and pictures. If you have an OpenGL 
driver for your graphics card, you can even do 3D. In addition to all of this, 
Allegro also supports transformations . Transformations allow you to 
rotate, translate, and scale the graphics on the screen, which makes it easy 
to create animated spaceships and floating rocks that can move and turn on 
the screen. 



Sounds 

Allegro has a full sound library that will allow you to build sounds into your 
game. 
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Puildiwg the game 

You’ll need to decide how you’re going to structure your source 
code. Most G programmers would probably break down the 
code into separate source files. That way, not only will you be 
able to recompile your game quicker, but you’ll also be dealing 
with smaller chunks of code at a time. That will make the whole 
process a lot less confusing. 

There are many, many ways of splitting up your code, but one 
way is to have a separate source file for each element that will be 
displayed in the game: 


1 —— 


asteroid.c 



blast.c 


^ — The spaceship y/i|| be able {o -five its C^v\y\ov\ ai 
passi% asiciroids, so you will Code -fco dvaw 
and move a ddKmon blas-t across -the 



\ Unlike i\\t astcvoids, you y/ill fv-obablY Y\ttd 

{p only ov\t -tV^csc a*t a 七 w. 



^ — I 仏 always jood -to have a scpav-a-tc souvdc -file -to 
deal y/ith 七 he CoYt o( -the game. The Code m hev-e 
will need "to lis-tc^ -Po\r kcypv-csscs, \ru^ a 七 imev, and 
also -tell all o-P -the oihc\r spaceships, vodks, a^d 
blas-ts -fco dv^dw "themselves oy\ "the sdv*ccr>. 


blasteroids.c 
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The spaceship 

When you’re controlling lots of objects on a screen, it’s useful to 
create a struct for each one. Use this for the spaceship: 


"The di\rcdtioh its poihtihg 


typedef struct { 

float sx;^ \H\\cct oy\ 

float sy; 


float heading 



float speed; 


int gone; 


ALLEGRO COLOR color 


What the spaceship looks like 

If you set up your code to draw around the origin (discussed later), 
then you could draw the ship using code like this: 

The variable s is a pointer to a Spaceship struct. Make the 
ship green. 



Collisions 

If your spaceship collides with a rock, it dies immediately and 
the player loses a life. For the first five seconds after a new ship is 
created, it doesn’t check for collisions. The new ship should appear 
in the center of the screen. 
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Spaceship behavior 

The spaceship starts the game stationary in the center of the screen. 
To make it move around the screen, you need to make it respond to 
keypresses: 


丁 he up dovm 

針 ows addclcvatc . ^ 

ahd dcdclc\ratc the 
spaceship. 




TV^c a_ 


T hc h 9 ^ 如。 w 

Zl s ' 


Wise. 



Make sure the ship doesn’t accelerate too much. You probably don’t 
want the spaceship to move forward more than a couple hundred 
pixels per second. The spaceship should never go into reverse. 
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Reading keypresses 


The G language is used to write code for almost every piece of 
computer hardware in the world. But the strange thing is, there’s 
no standard way to read a keypress using G. All of the standard 
functions, like f gets (), read only the keys once the return key has 
been pressed. But Allegro does allow you to read keypresses. Every 
event that’s sent to an Allegro game comes in via a queue. That’s just 
a list of data that describes which keys have been pressed, where the 
mouse is, and so on. Somewhere, you’ll need a loop that waits for an 
event to appear on the queue. 


Even sudh as gcidhav-0 

-to bu-f-fc\r a^y dhavad-tcv-s you 
"type you hi 七 \rc*tuVh. 


ALLEGRO_EVENT_QUEUE ^queue; 

queue = al_create_event_queue () ; 〈一 ■ You 3^ e 赠 ' u ，喊 如七 W’ 

ALLEGRO_EVENT event; ■ 

al—wait—for—event (queue, &event) ; ~This waits -Pov av\ ever^i -fvom 七 he ^ucuc. 


Once you receive an event, you need to decide if it represents a 
keypress or not. You can do that by reading its type. 


if (event.type == ALLEGRO_EVENT_KEY_DOWN) { 
switch(event.keyboard.keycode) { 
case ALLEGRO_KEY_LEFT Tu\rv> i\\t sK'if left. 


break; 

case ALLEGRO_KEY_RIGHT : 辦 

break; 

case ALLEGRO—KEY—SPACE: Five! 


break; 
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The blast 

Take that, you son of a space pebble! The spaceship’s cannon can 
fire blasts across the screen, and it’s your job to make sure they 
move across the screen. This is the struct for a blast: 



糾 ast appearance 

The blast is a dashed line. If the user hits the fire key rapidly, the 
blasts will overlay each other and the line will look more solid. That 
way, rapid firing will give the impression of increased firepower. 



Plast behavior 

Unlike the other objects you’ll be animating, blasts that disappear 
off the screen won’t reappear. That means you’ll need to write code 
that can easily create and destroy blasts. Blasts are always fired in 
the direction the ship is heading, and they always travel in a straight 
line at a constant speed — say, three times the maximum speed of 
the ship. If a blast collides with an asteroid, the asteroid will divide 
into two. 




The asteroid 


Use this struct for each asteroid: 


typedef struct 


it is oh the sC^y\ 


< 


l/VWidii y/ay *iVs headed 

Cu\r\rcr>-t v-o-tatio^ / 


float sx; 
float sy; 


float heading 
float twist; 


float speed; 


Speed o( roiahor\ per -frame 〆 ^ ^ float rot—velocity ; 
Sdalmj -fad-fcov- -fco i-ts siic - float scale; 


Was *i*t bccr> dcs*tvoycd? 


Asteroid appearance 



^int gone; 

ALLEGRO COLOR color 


This is the code to draw an asteroid around the origin: 


al 

draw 

line (-20 

, 20, - 25, 

5, 

a->color A 

2 . Of); 

al 

draw 

line (-25 

,5, -25, 

-10, 

a->color 

, 2.Of); 

al 

draw 

line (-25 

r - 10 a ， 

-10 

, a->color, 2 . 0 f); 

al 

draw 

line (-5 , 

- 10, -10, 

-20 

,a->color, 2 . 0 f); 

al 

draw 

line (-10 

r -20 r 5 , 

-20, 

a->color 

, 2.Of); 

al 

draw 

line (5 , 

-20, 20, - 

10, 

a->color , 

2 . Of); 

al 

draw 

line (20 , 

- 10 , 20, 

- 5, 

a->color , 

2 . Of); 

al 

draw 

line (20 , 

-5, 

a->color , 2 . 

Of); 

al 

draw 

line (0 , 

0, 20, 10, 

a->color , 2 . 

Of); 

al 

draw 

line (20, 

10, 10, 20, a 

->color, 

2.Of); 

al 

draw 

line (10, 

20, 0, 15 

a a- 

>color, 2 

• Of); 

al 

draw 

line (0, 

15, - 20, 20, a. 

- >color A 

2.Of); 
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How the asteroid moves 

Asteroids move in a straight line across the screen. Even though they 
move in a straight line, they continually rotate about their centers. If 
an asteroid drifts off one side of the screen, it immediately appears 
on the other. 



Whew the asteroid is hit by a blast 

If an asteroid is hit by a blast from the spaceship’s cannon, it 
immediately splits into two. Each of these parts will be half the 
size of the original asteroid. Once an asteroid has been hit/split a 
couple of times, it is removed from the screen. The player’s score 
increases with each hit by 100 points. You will need to decide how 
you will record the set of asteroids on the screen. Will you create 
one huge array? Or will you 




The game status 



There are a couple of things you need to display on the screen: the 
number of lives you have left and the current score. When you’ve 
run out of lives, you need to display “Game Over!” in big, friendly 
letters in the middle of the screen. 


A 


Blasteroids 




Use trawsformatiows to move things around 

You’ll need to animate things around the screen. The spaceship 
will need to fly，and the asteroids will need to rotate, drift, and even 
change size. Rotations, translations, and scaling require quite a lot 
of math to work out. But Allegro comes with a whole bunch of 
transformations built in. 

When you’re drawing an object, like a spaceship, you should 
probably just worry about drawing it around the origin. The origin 
is the top-left corner of the screen and has coordinates (0, 0). The 
x-coordinates go across the screen, and the y-coordinates go down. 

You can use transformations to move the origin to where the object 
needs to be on the screen and then rotate it to point the correct way. 

Once that’s all done, all you need to do is draw your object at the 
origin and everything will be in the right place. 

For example, this is one way you might draw the spaceship on the 
screen: 


void draw—ship(Spaceship* s) 

ALLEGRO—TRANSFORM transform; 
al—identity—transform(&transform); 

al—rotate—transform(&transform, DEGREES(s->heading)); 

al_translate_transform(&transform, s—>sx, s->sy); 

al_use_transform(&transform); 

al—draw—line(-8, 9, 0, -11, s->color, 3.0f); 

al—draw—line(0, - 11, 8 , 9, s->color, 3.0 f); 

al draw line (-6, 4, -1, 4, s->color, 3.0f); 

4 , s->color, 3.0 f); 


al draw line (6, 4, 1, 
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The finished product 

When you’re done, it’s time to play Blasteroidsl 



Tkere are lots oi otker tilings you 
could cto to enkance tke game. As 
an example, wky not try to get it 
working witk OpenCV? Let us know 
kow you get on at Head First 






Leaving toww... 



If s been great having you here m Cville! 

We’re Sad to see you leave, but there’s nothing like taking what you’ve learned 
and putting it to use. There are still a few more gems for you in the back of the book and 
an index to read through, and then it’s time to take all these new ideas and put them into 
practice. We’re dying to hear how things go, so drop us a line at the Head First Labs 
website, www.headfirstlabs.com ，and let us know how C is paying off for YOU! 
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命 


The top ten things 
參 (we didn’t cover) 



Even after all that, there’s still a bit more. 

There are just a few more things we think you need to know. We wouldn’t feel right about 
ignoring them, even though they need only a brief mention, and we really wanted to give 
you a book you’d be able to lift without extensive training at the local gym. So before you 
put the book down, read through these tidbits. 
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operators 


# 1. Operators 

We’ve used a few operators in this book, like the basic arithmetic 
operators +, and /, but there are many other operators 
available in G that can make your life easier. 

Increments and decrements 

An increment and a decrement increase and decrease a number by 
1. That’s a very common operation in G code, particularly if you 
have a loop that increments a counter. The G language gives you 
four simple expressions that simplify increments and decrements: 

Unease i by I, tkh —^ ++± 
v*ctu\rh "the hCw value. 

I^v-casc » by I) 七 ^' 

old aluc. 土 ++ 


Pcd\rcasc i by /, __ 

v*ctu\rh the hew value. 

pctv-casc *i fey I) 从⑼ 
v-cWv' old value- 土 


Each of these expressions will change the value of i. The position 
of the ++ and -- say whether or not to return the original value 
of i or its new value. For example: 

int i = 3; 

int j = i++; A-fW -tV^'is 1’me，j 二二 $ ad 丨二二千 . 

The ternary operator 

What if you want one value if some condition is true, and a 
different value if it’s false? 


if (x == 1) 
return 2; 
else 

return 3; 


G has a ternary operator that allows you to compress this code right 

d0Wnt0thef ° ll0Wing： return ” 2 : ^ ^ ^ 

个 个 
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Pit twiddling 

G can be used for low-level programming, and it has a set of 
operators that let you calculate a new series of bits: 


Operator 

Description | 

〜 a 

The value of a with all the bits flipped 

a&b 

AND the bits of a and b together 

a | b 

OR the bits of a and b together 

a A b 

XOR the bits of a and b together 

« 

Shift bits to the left (increase) 

» 

Shift bits to the right (decrease)_ 


The << operator can be used as a quick way of multiplying an 
integer by 2. But be careful that numbers don’t overflow. 

Commas to separate expressions 

You’ve seen for loops that perform code at the end of each 
loop: 

for (i = 0; i < 10; i++) ⑼ 七 v/ilUaff ⑼ a 七七 he 

But what if you want to perform more than one operation at 
the end of a loop? You can use the comma operator: 

for ( i = 0 ; i < 10 ; i ++, j++) ^ — ► i olhd j. 

The comma operator exists because there are times when you 
don’t want to separate expressions with semicolons. 


<Jc catii loop. 
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Preprocessor directives 

You use a preprocessor directive every time you compile a program 
that includes a header file: 

#include <stdio . h>^-^ ^* ,s * ,s a f^fv-otcsso\r 

The preprocessor scans through your G source file and generates 
a modified version that will be compiled. In the case of the 
#include directive, the preprocessing inserts the contents of the 
stdio.h file. Directives always appear at the start of a line, and they 
always begin with the hash (#) character. The next most common 
directive after #include is #def ine: 

#define DAYS OF THE WEEK 7 


printf("There are %i days of the week\n n , DAYS_OF THE—WEEK); 

The # define directive creates a macro. The preprocessor will 
scan through the G source and replace the macro name with the 
macro’s value. Macros aren’t variables because they can never 
change at runtime. Macros are replaced before the program even 
compiles. You can even create macros that work a little like 

functions: % * IS a parameter "to the 〜 o. 

#define ADD 一 ONE (x) ( (x) +1) Be CarcQ io use pav-chlhcscs with 


printf ( "The answer is %i\n n , ADD ONE (3)); 


This is v/'ill ou*tfu*t W TV>C 3y>s>wcv* is 


The preprocessor will replace ADD—ONE ( 3 ) with ( (3) + 1) 

before the program is compiled. 


Conditions 

You can also use the preprocessor for conditional 
compilation. You can make it switch parts of the source 

code on or off: ^ ^ SP/\N|Stt 〜也… 

#ifdef SPANISH 

_ ...mdude "this CoAt- 

char ^greeting = "Hola" 


#else 

char ^greeting 

#endif 


Hello"; ^ 


灼。七, mtludc *tWis dodc* 


This code will be compiled differently if there is (or isn’t) a 
macro called SPANISH defined. 
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The static keyword 

Imagine you want to create a function that works like a counter. 

You could write it like this: 

int count = 0; ^ ,s ^H s * 

int counter() 

{ 

return ++count; ^ - l^e^i ihc douht eadk 


What’s the problem with this code? It uses a global variable called 
count. Any other function can change the value of count 
because it’s in the global scope. If you start to write large programs, 
you need to be careful that you don’t have too many global 
variables because they can lead to buggy code. Fortunately, G lets 
you create a global variable that is available only inside the local 


scope of a function: 

^ouht is still a global 
vav-iablc, but it 

only be aucsscd 

inside "this -fuhd'tioh. 


int counter() 


T\\c s*ta*ti 乙 keyv/ov-d means 
•tWis variable will keep rb value 
tails -to dou^-tcv-O. 


static int count 

return ++count; 


0 


The static keyword will store the variable inside the global area 
of memory, but the compiler will throw an error if some other 
function tries to access the count variable. 


static can also make things private 


You can also use the static keyword outside of functions, 
static in this case means “only code in this .c file can use this.” 


For example: 


static int days = 365; 


)\a c ^ y \ use *tWis variable or\ly 
\i\Ac tuv-v-cir\*t souv-tc V»lc. 


You dah ta\\ this^. static 
+Uhd-fcioh ohly 
•(Vorw ihsidc this • • • 
sou\rdc -Pile. } 


void update account(int x) 


{ 


The static keyword controls the scope of something. It will 
prevent your data and functions from being accessed in ways that 
they weren’t designed to be. 
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# 4. How big stuff is 

You’ve seen that the sizeof operator can tell you how much 
memory a piece of data will occupy. But what if you want to 
know what range of values it will hold? For example, if you 
know that an int occupies 4 bytes on your machine, what’s the 
largest positive number you can store in it? Or the largest negative 
number? You could, theoretically, work that out based on the 
number of bytes it uses, but that can be tricky. 

Instead, you can use the macros defined in the limits.h header. 
Want to know what the largest long value you can use is? It’s 
given by the LONG_MAX macro. How about the most negative 
short? Use SHRT—MIR Here’s an example program that shows 
the ranges for ints and shorts: 


#include <stdio.h> 

#include <limits.h> 

int main() 

{ 

printf ("On this machine an int takes up %lu bytes\n 
printf("And ints can store values from %i to %i\n n , 
printf("And shorts can store values from %i to %i\n 
return 0; 


,sizeof (int)); 

INT—MIN, INT—MAX); 

,SHRT MIN, SHRT MAX); 


File Edit Window Help HowBiglsBig 


On this machine an int takes up 4 bytes 

And ints can store values from -2147483648 to 2147483647 



The macro names come from the data types: INT (int), SHRT 
(short), LONG (long), CHAR (char), FLT (float), DBL 
(double). Then, you either add —MAX (most positive) or —MIN 
(most negative). You can optionally add the prefix U (unsigned), 
S (signed), or L (long) if you are interested in a more specific 
data type. 
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巧 . Automated testing 

It’s always important to test your code, and life becomes a lot 
simpler if you automate the tests. Automated tests are now used 
by virtually all developers, and there are many, many testing 
frameworks used by G programmers. One that’s popular at Head 
First Labs is called AceUnit: 

http:/ / aceunit.sourceforge.net/ 

AceUnit is very similar to the xUnit frameworks in other languages 
(like nUnit and jUnit). 

If you’re writing a command-line tool and you have a Unix-style 
command shell, then another great tool is called shunit2. 

http:/ / code.google, com /p / shunit2 / 

shunit2 lets you create shell scripts that test scripts and 
commands. 
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# 6. More oh gcc 

You’ve used the GNU Compiler Collection (gcc) throughout this book, 
but you’ve only scratched the surface of what this compiler can do 
for you. gcc is like a Swiss Army knife. It has an immense number 
of features that give you a tremendous amount of control over the 
code it produces. 

Optimization 



gcc can do a huge amount to improve the performance of your 
code. If it sees that you’re assigning the same value to a variable 
every time a loop runs, it can move that assignment outside the 
loop. If you have a small function that is used only in a few places, 
it can convert that function into a piece of inline code and insert it 
into the right places in your program. 

It can do lots of optimizations, but most of them are switched off 
by default. Why? Because optimizations take time for the compiler 
to perform, and while you’re developing code you normally want 
your compiles to be fast. Once your code is ready for release, you 
might want to switch on more optimization. There are four levels 
of optimization: 


Flag 

Description 

-o 

If you add a -0 (letter O) flag to your gcc command, you will get the 
first level of optimizations. 

-02 

For even more optimizations and a slower compile, choose -02. 

-03 

Forj 以 more optimizations, choose -03. This will include all of the 
optimization checks from -0 and -02, plus a few extras. 

-Ofast 

The maximum amount of optimization is done with -Of ast. This is 
also the slowest one to compile. Be careful with -Of ast because the 
code it produces is less likely to conform to the G standards. 


' 
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Warnings 

Warnings are displayed if the code is technically valid but does 
something suspicious, like assign a value to a variable of the 
wrong type. You can increase the number of warning checks with 

-Wall: 

gcc fred.c -Wall -o fred 

The -Wall option means “All warnings,” but for historic reasons 
is doesn’t actually display all of the warnings. For that, you should 
also include -Wextra: 

gcc fred.c -Wall -Wextra -o fred 


mca 怕 w *brca 七 as errors. 

-Werror is useful if several people are working on the same code 
because it will help maintain code quality. 

For more gcc options, see: 

http:/ /gcc.gnu.org/onlinedocs /gcc 


Also, if you want to have really strict compilation, you can make the 
compile fail if there are any warnings at all with -Werror: 


gcc fred.c -Werror -o fred 


TW«s 
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# 7. More on make 

ma ke is an incredibly powerful tool for building G applications, 
but you’ve only had a very simple introduction to it in this book. 
For more details on the amazing things you can do with make, see 
Robert Mecklenburg’s Managing Projects with GNU Make.. 

http:/ / shop.oreilly.com/product/9780596006105.do 
For now, here are just a few of its features. 

Variables 

Variables are a great way of shortening your makefiles. For 
example, if you have a standard set of command-line options you 
want to pass to gcc, you can define them with a variable: 

CFLAGS = -Wall -Wextra -v 

fred : fred.c 

gcc fred.c $ (CFLAGS) -o fred 

You define a variable using the equals sign (=) and then read its 
value with $(...), 

Using ^ ^ and @ 

Most of the time, a lot of your compile commands are going to 
look pretty similar: 


fred : fred.c 

gcc fred.c -Wall -o fred 

In which case, you might want to use the % symbol to write a more 
general target/recipe: 

youVc dvcatiha <-Pilc>. 

thch look -pov- <^ilc>.d. 〆 ％ % • C 

,s gCC J" -Wall -o $@ ^ 

value t -f ile). ^ - 

This looks a little weird because of all the symbols. If you want 
to make a file called fred : this rule tells make to look for a file 
called fred.c. Then, the recipe will run a gcc command to create 
the target f red (given by the special symbol $@) using the given 
dependency (given by $@). 
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Implicit rules 

The make tool knows quite a lot about G compilation, and it can 
use implicit rules to build files without you telling it exactly how. 
For example, if you have a file called fred.c, you can compile it 

without a makefile by typing: 


匕亡 will usually 

be aho-thev- 

Mmc -Poir 


File Edit Window Help MakeMyDay 


> make fred 
cc fred.c -o fred 



TWis This is dh imp|idi£ \rulc. 

scaled by 眯 akc, >/^ou*b 

us ^ 0Y/ * 


That’s because make comes with a bunch of built-in recipes. For 
more on make, see: 

http:/ / www.gnu.org/software/ make/ 
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# 8. Pevelopment tools 

If you’re writing G code, you probably care a lot about 
performance and stability. And if you’re using the GNU Compiler 
Collection to compile your code, you’ll probably want to take a look 
at some of the other GNU tools that are available. 


gdb 

The GNU Project Debugger (gdb) lets you study your compiled 
program while it’s running. This is invaluable if you’re trying to 
chase down some pesky bug. gdb can be used from the command 
line or using an integrated development environment like Xcode or Guile. 

http:/ / sourceware.org/gdb/ download/ onlinedocs /gdb / index.html 


gprof 

If your code isn’t as fast as you’d hoped, it might be worth profiling 
it. The GNU Profiler (gprof) will tell you which parts of your 
program are the slowest so that you can tune the code in the most 
appropriate way. gprof lets you compile a modified version of 
your program that will dump a performance report when it’s 
finished. Then the gprof command-line tool will let you analyze 
the performance report to track down the slow parts of your code. 

http:/ / sourceware.org/binutils / docs-2.2 2 /gprof/ index.html 


gcov 


Another profiling tool is GNU Coverage (gcov). But while gprof 
is normally used to check the performance of your code, gcov is 
used to check which parts of your code did or didn’t run. This is 
important if you’re writing automated tests, because you’ll want to 
be sure that your tests are running all of the code you’re expecting 
them to. 


http:/ /gcc.gnu.org/onlinedocs /gcc / Gcov.html 
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# 9. Creating &Uls 

You haven’t created any graphical user interface (GUI) programs in 
any of the main chapters of this book. In the labs, you used the 
Allegro and libraries to write a couple of programs that 

were able to display very simple windows. But GUIs are usually 
written in very different ways on each operating system. 

Uwux ^ 

Linux has a number of libraries that are used to create GUI 
applications, and one of the most popular is the GIMP toolkit 
(GTK+): 


http:/ / www.gtk.org/ 

GTK+ is available on Windows and the Mac, as well as Linux, 
although it’s mostly used for Linux apps. 

Windows 

Windows has very advanced GUI libraries built-in. Windows 
programming is a really specialized area, and you will probably 
need to spend some time learning the details of the Windows 
application programming interfaces (APIs) before you can easily build 
GUI applications. An increasing number of Windows applications 
are written in languages based on G, such as G# and C++. For an 
online introduction to Windows programming, see: 

http:/ / www.wiupwg.oirg/tutorial/ 

The Mac 一 Carbon 

The Macintosh uses a GUI system called Aqua. You can create 
GUI programs in G on the Mac using a set of libraries called 
Carbon. But the more modern way of programming the Mac is 
using the Cocoa libraries, which are programmed using another 
G-derived language called Objective-C. Now that you’ve reached the 
end of this book, you’re in a very good position to learn Objective-C. 
Here at Head First Labs, we love the books and courses on Mac 
programming available at the Big Nerd Ranch: 


http:/ / www.bignerdranch.com/ 
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# 10. Reference material 

Here’s a list of some popular books and websites on G programming. 

Brian W. Kernighan and Dennis M. Ritchie, The C Programming Language 
(Prentice Hall; ISBN 978-0-131-10362-7) 

This is the book that defined the original G programming language, and 
almost every G programmer on Earth has a copy. 


Samuel P. Harbison and Guy L. Steele Jr., C; A Reference Manual 
(Prentice Hall; ISBN 978-0-130-89592-9) 

This is an excellent G reference book that you will want by your side as 
you code. 


Peter van der Linden, Expert C Programming 
(Prentice Hall; ISBN 978-0-131-77429-2) 

For more advanced programming, see Peter van der Linden’s excellent book. 


Steve Oualline, Practical C Programming 
(0 ， Reilly; ISBN 978-1-565-92306-5) 

This book outlines the practical details of G development. 


Websites 

For standards information, see: 

http:/ /pubs.opengroup.org/onlinepubs/9699919799 / 


For additional G coding tutorials, see: 
http:/ / www.cprogmmming.com/ 

For general reference information, see: 
http:/ / www.cprogmmmingreference.com/ 

For a general G programming tutorial, see: 
http:/ / www.CTasseux.com/books/ctutorial/ 
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參 Revision roundup ♦ 



Ever wished all those great C facts were in one place? 

This is a roundup of all the C topics and principles we’ve covered in the book. Take a look 
at them, and see if you can remember them all. Each fact has the chapter it came from 
alongside it, so it’s easy for you to refer back if you need a reminder. You might even want 
to cut these pages out and tape them to your wall. 
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Basics 


Simple arc 
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before you >t\ay\ it 
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youv program i-f i*t Compiles. 



while repeats £ode as lo^ as a 
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Pointers and memory 


sdaJdi' f%) v/ill alloy/ a user 

七 o eirtev" a ^umbc\r % div^ettly. 


A thav" pom 七 er variable % is 
declared as eMar 本％ • 


hrtializ^ a hcv/ avray y/i-th a 

艾 brm% a^d rt v/ill dopy rb 




Lodal variables av-c scored or\ 

七 he s-tatk. 


f% is dal led a pom-tev" -to 


A^ay variables be used as 

pom 七 en 
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Strings 
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s 七 rle 灼 0 -fmds 七 he o-f a 

s 七 〆 …士 
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s.mHdvB 3 


sx m PH. VB 3 


s.mHdvB} 


s.ml PH. VI 0 
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sx m PH. VH 3 














data streams 


Data streams 


C -fuhdtio^s like Bv\d 

sta^-fO use 七 he S^ahdavd 
七 pu 七 Bv\d Sta^dav-cl l^pu-t io 


The £-tar\da\rd l^pu-t reads 

-the keyboav-d by de-fault 


The £idr\darcl Brror is a 
separa 七 e ou 切 u 七 m 七 ⑼ ded -fov 

evror messages. 


么 u drca^tc dus-tom da 七 a 

s-t\rc3ms y/i-th -fo^C^O'-filc^amC^ 
mode). 


The Standard 七 pu 七 ^ocs -to 

七 he display by de-fault 


4u y/hcv*c "the 

S-ta^dav-d 七 pu 七 , a^d 

Svyor Bre tor\r\tt{jtd h> usm^ 
rcdiv'cdtioh. 


You p\rm 七七 o 七 he £^dhdd\rcl 

&rrov usm^ fpvirrtf(s 七 devr, . ). 




The mode £dK\ be u y/^ *to y/\ri-tcj 

V’ *to read, oy “a” io append. 
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Command—ImC 3\rc 

^dsscd *bo w\3i^0 3s 3h 3v*v*3y o*f 
pom 七 en 


The y+op 七 0 -fu^d-tioh makes i-t 
easier h> v^edd domma^dl—Ime 

options. 
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Datatypes 




•nrts av*c di^-fcv-c^ siz^s ov\ 

diKcv*crrt madhmcs. 


Use -floa^ts -fo\r mos-t 
poiirts. 


Use doubles -for really predisc 
pomts. 


mHdvIP 


緑 Ids 
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MttltiPle files 


Spli^t dedldrd^kiohs 

ddmrtiom 



mHdvIP 


mHdvIP 


mHdvIP 


mHdvs 


you are here ► 


561 









structs 


Structs 



-tyfcdc-f lets you Octant 

alias -fov a daia iyfc. 


You £dr\ \redd s^brutt fields v/i 七 h 
do^t ^o^tatioh. 



一 > y\o{^hov\ lets you easily 
update -fields usm^ a s-trud^t 

pom 七 er. 


Pcsi^a^tcd mi 七 ializ*C\rs lei you 
se 七 s-tvud-t Sv\d u^ioh fields by 
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data structures 


Data structures 



Dyhamid ddia s-trud-turcs use 
\rcdu\rsivc s 七 rutts. 


A Imked list is a dld^bd 

structure. 



Data be *msc\r-tcd easily 
•nrto a I'mked list 
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revision roundup 


The s-tatk is used -fov \ota\ 
variables. 


mallodO allota 七 es memovy oy\ 
-the heap. 


s 七 rdupO y/ill trea 七 e a dopy 
a oh -the heap. 


val^rmd C3r\ help you ^tvadk 
dov/r\ memovy ledks. 


Unlike 七 he s-tadk, heap memory 
is 竹。七 au 七 oma 七 itally released. 


-frccO releases memovy or\ -the 
heap. 


i 

A r^emovy leak is allodaied 


memovy you hO loh^CV" 

圓 

addess. 
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advanced functions 


j^vanced fimctions 




Eath so\r 七 -fuhdtio^ v\ttds 
a {p a dompav"a-to\ 

-Pu^dtio^. 


A^ays o-f -fuhdtio^ pom 七 
CSv\ help ruh 

o^s -for ditfevr 妁七 "type 

did^td* 


Fuhdtioh pom-ters av*c or^ly 
pom^tc^rs -tha^t dov\{, v\ttd *thc 
决 Sr\d f opeta 七 ors, bu^t you 6Br\ 
use "them i-f you v/a 妁七 io- 


、 sor 七 0 v/ill sov •七 a^rvay. 


CompaV"a-to\r -fu^dtiohs decide 
how bo ordev* 七 v/o picdcs o-f 


/ MldVlP 


/ mds 
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static and dynamic libraries 


Static and aVnamic libraries 



The ar dommdhd drcaics a 

library archive o-f object -files. 


-L<^amc> adds a dircd-to\ry -to 
七 he list of s-bdhddrdl libv-ary 
di^edioHes. 



-I<hamc> adds a directory to 
七 he list o-f s^td^clav'cl mdlude 
div'Cd^toHcs. 





0 mdvB3 
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Dy^amid li 

di-f-Pcrc^-t 


libraries have 

hdmCS OV\ diKere 妁七 
opc\ratm^ sys-tems. 


Dyhamit libraries have so, 

dylib, dll，or dll d c^Chsiohs. 
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Processes and commimication 


system 0 y/ill r\AV\ d like d 
dohsolc dommdhdl 


-forkO + c^cdO 

d^rcaics d thild frodcss. 



exedO 二 lis-t o-f a\r^s. 

exedeO 二 I is 七 of + c^viro^mc^t 

c^edlpO =• lis-t ar^s + scardh paih. 

c^cdvO =. array <^P ar^s. 

c^cdvcO array o-f a\r^s + c^viro^mc^-t. 

c^cdvpO =1 arvay <^P a\r^s + search paih 


Processes da 妁 dommuhida-tc 

usm 5 PiP cs . 





o mdvHO 
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sockets and networking 


Sockets and networKin^ 



七 elnrt is a simple hc^tv/ovk 
dierrt. 


£cv*vc\rs BLAB : 

B 二 bihdO 
L 二 lis 七 ⑼ 0 
h 二 atdcfiO 
B 二 •m talkm& 


Use -fovkO {p dope v/i 七 h 
several dlichts ai o^tc. 


DNS 二 Dornd'm y\Brf\t sys^tci 


^c^tadd^rm-foO -f mds dddlv-esses 
by domain* 


it mLdvHo 


ii mLdVip 


u mLdvip 


昌 HdvIP 


昌 HdvIP 
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Threads 



Threads alloy/ a process -bo do 
move {\\Sv\ ov\t 七 3 七 {\\t 
sdme "time. 



P^)£|)< -threads (piWead) is a 
七 Weadn^ libvary. 


p 七 WeadjomO y/i|| y/ai*t -for d 
七 Wead *to -f inish. 


I-P 七 v/o -threads read Sv\d 
update 七 he same variable ； your 
iSM dodc v/ill be u^prcdidtablc. 



Threads share -the same global 
variables. 


Muic^cs av-c lodks -thai 

pvo 七 efrt shared data. 


p^tWca^mu^tc^uhlodkO 
releases -the 
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♦ Index^ 


Symbols & Numbers 

$ (dollar sign), $%, S A , and S@ compiler commands for 
makefiles 548 

\0 sentinel character 12 

& (ampersand) 

bitwise AND operator 20, 541 
&& (logical AND) operator 18, 20 
reference operator 43, 48 
< > (angle brackets) 

>> (bitwise shift left) operator 541 
in header files 180, 354 
redirecting Standard Input with < 111 
redirecting Standard Output with > 112, 430 
redirection using > and 2> operators 432 
* (asterisk) 

accessing array elements 61 
indirection operator 48 
in variable declarations 74 
A (caret), bitwise XOR operator 541 
， (comma) 

separating expressions 541 
separating values in enums 255 
{ } (curly braces) 

enclosing function body 6 
enclosing statements 14 
.dot notation, setting value of unions 248 
.(dot) operator, reading struct fields 222 
... (ellipsis) 345 


=(equals sign) 

assignment operator 13 
==(equality) operator 13 
! (exclamation mark), not operator 18 
# (hash mark), beginning preprocessor directives 542 
- (minus sign) 

— (decrement) operator 13, 540 
negative numbers and command-line arguments 155 
prefacing command-line options 155 
-=(subtraction and assignment) operator 13 
()(parentheses), caution with, when using structs 240 
% (percent sign) 

%li format string 52 
%p format string 48, 52 
(pipe symbol) 

bitwise OR operator 20, 541 
connecting input and output with a pipe 131 
|| (logical OR) operator 18, 20 
+ (plus sign) 

+= (addition and assignment) operators 13 
++ (increment) operator 13, 540 
-> pointer notation 241, 245 
? (question mark) 540 

?: (ternary) operator 540 
“，’ (quotation marks, double) 
enclosing strings 13 
in header files 180, 354 
(quotation marks, single) in strings 13 
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;(semicolon), separating values in structs and unions 255 
/ (slash) 

/* and */ surrounding comments 8 
/ / beginning comments 8 
I (square brackets) 
array subindex operator 61 
creating arrays and accessing elements 96 
in variable declarations 74 
〜 (tilde), bitwise complement operator 541 
_ (underscore), replacing spaces in web page name 498 
8-bit operating systems 168 
32-bit operating systems 168 
size of pointers 54 
64-bit operating systems 168 
size of pointers 54 

A 

accept() function 471 
AceUnit framework 545 
alarm() function 458 

calls to, resetting the timer 459 
sleep() function and 458 
alarm signal, SIGALRM 458 
Allegro library 526 

creation of game elements 527 
AND operator (&) 20, 541 
AND operator (&&) 18, 20 
animation, using transformations 535 
ANSI C 2 
Arduino 207—216 
Arduino board 209 
building the physical device 210 
G code for, what it does 212 


finished product 215 
plant monitor and moisture sensor 208 
useful functions 214 
writing G code in Arduino IDE 209 
args parameter 345 
arguments, function 32 

fixed argument in variadic functions 345, 346 
array functions, execv( ) ， execvp(), and execve() 406 
arrays 11 

array of arrays versus array of pointers 98 
assigned to pointers, pointer decay and 59 
char pointers versus char arrays in data structure 286 
creating array of arrays 85, 96 
fixed length of 268 
of function pointers 338-342 
indexes 13, 61 
length of 13 
linked lists versus 274 
strings as character arrays 12 
structs versus 220, 225 
using to copy string literals 74 
variables declared as 74 
array variables 

differences from pointers 59 
use as pointers 54 

Assembly language, translation of G code into 184 
assignments 

=(assignment) operator 13 
chaining 33 

compound assignment operators 13 
struct assigned to another variable 226 
struct to another struct 238 
associated arrays or maps 296 
asteroids (Blasteroids game) 533 
autoconf tool 202 
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automated testing 545 
automating builds with make tool 198 

B 

binary literals, not supported in G 261, 265 
binary numbers 163 
binary trees 296 

binary values, converting between hexadecimal and 261 
binding to a port 470 
bitfields 262, 265, 563 

using to construct customer satisfaction survey 
(example) 263 

bit size of computers 168 

bits, operators for manipulation of 541 

bitwise AND operator (&) 20, 541 

bitwise complement operator (〜） 541 

bitwise OR operator (|) 20, 541 

bitwise shift left operator (<<) 541 

bitwise XOR operator ( A ) 541 

BLAB: Bind, Listen, Accept, Begin 470 

Blasteroids game. See game, Blasteroids project 

blasts fired by spaceship (Blasteroids game) 532 

block statements 14 

body of a function 6 

boolean operators 18 

boolean values, representation in G 18 

bound port, reuse by socket 477 

break statements 26, 28, 39 

exiting loops 31 

not breaking out of if statements 31 
buffer overflows caused by scanf() function 66 
build tools 202 

GMake 526 
bus errors 13 


c 

G 

basics of 554 
how it works 2 

reference materials for programming 552 
similarities to and influence on other languages 39 
C++ 39 
Gil standard 2 

c89 notation for first field of a union 248 

G99 standard 2 

cameras 

grabbing image from webcam 392 
showing current webcam output 393 
taking input from computer camera 392 
Carbon libraries 551 
card counting 16 

program for, writing in G 17, 19—21 

modifying program to keep running count of card 
game 35 

testing program 38 
case statements 26, 28 
casting floats to whole numbers 164 
chaining assignments 33 
char** pointer 320, 333 
char type 159, 161 
arithmetic with 182 

char pointers versus char arrays in data structure 286 
defined 162 

checksum() function 352 
child process 420, 450 

clients talking to server 486 
listening to directly 442 
piped commands on command line 443 
redirecting Standard Output to file 435-440 
running with fork() and exec() 421—425 
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classes, structs versus 225 
GMake 526 
Cocoa libraries 551 
collisions 529 
command-line arguments 

avoiding ambiguity by splitting main arguments from 
options using — 155 

execl( ) ， execlp(), and execle() functions 405 
main() function with 141 
command-line options 148 

questions and answers on 155 
using getopt() function for 149 
command line, piping commands together on 443 
command path 409 
commands, types of 14 

comma-separated data, reading and displaying inJSON 
format 105 

comma (,), separating expressions 541 
comments 5 
formatting 8 

comparator functions 327—333 

writing for different sort descriptions 328-333 
compilation 2 

automating builds with make tool 198—205 
behind-the-scenes look at 184 
compiling a program using gcc 9 
partial compiles 191-196 
precompilation and 180 
reason for compiling G 39 

speeding up for programs in multiple source files 189 
compiled code, saving copies of 190 
compilers 9. See also gcc 

BE the Compiler exercise 23 
G standard supported by 8 
debug information from 308 
finding standard header file directories 355 
interview with gcc 22 
conditional compilation 542 


connection, accepting from client 471 
constants 

defined 80 
string literals as 73 
const char 218,220 
const keyword 76, 79 
continue statements 31, 39 
control statements 14 
convert command 449 
count variable 543 

create() function, using dynamic allocation 282, 284 
fixing with strdup() function 286 
GreateProcess() function (Windows systems) 426 
G Standard Library 127 
Gtrl-G, stopping programs 451 
curl/wget programs 449 
cvGalcOpticalFlowFarneback() function 393 
cvGreateGameraGapture() function 392 
cvNamedWindow() function 393 
cvQueryFrame() function 392 
cvShowImage() function 393 
Gygwin 449 

fork() function and 426 

including PATH variable when passing environment 
variables on 407 

installing before calling fork() on Windows 420 
telnet program 468 

D 

data entry 

capabilities of scanf() versus fgets() 68 
fgets() as alternative to scanf() 67 
using pointers for 65 
data streams 

creating your own 138 
duplication with dup2() function 433 
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handling in a typical process 431 
opening, checking for problems with 147 
printing to 122 

replacement by redirection 432 
sockets 470 

summary of important points 558 
typical data streams versus sockets 472 
data structures 

questions and answers about 274 
summary of important points 564 
types other than linked lists 295 
data types 158 

bytes in memory occupied by, getting with sizeof 280 
casting floats to whole numbers 164 
data not having single type 246 

errors caused by conflicting types in example program 
170 

macros determining size of 544 

matching type of value to type of variable it’s stored 
in 163 

no function data type in G 319 
parameters in variadic functions 349 
pointer variables 62 

prefixing with unsigned or long keywords 164 
process ID 423 
quick guide to 162 
size of 167 

sizes on different operating systems 168 
structs 220 
summary of 560 
unions 249 

values stored in unions 254 


decimal point numbers. See also floating-point numbers; 
float type 

computers’ representation of 168 
declarations 
defined 79 

function, splitting from definition 173, 561 
decrement operator (--) 13, 540 
#define directive 542 

definitions, function, splitting from declaration 173, 561 
dependencies 198 

identifying for make tool 199 
dereferencing 48, 52 
descriptor table 

important points about 440 
Standard Input, Output, and Error in 432 
designated initializers 248, 265 

setting initial values of struct fields 249 
design tips for small tools 129 
/ dev/tty program 441 
development tools 550 
device drivers 403 
DNS (domain name system) 493 
domain names 491 

connecting client socket to remote domain name 492 

creation of sockets with IP addresses or domain names 
499 

double type 159, 161 
defined 162 
doubly linked lists 296 
do-while loops 29, 39 
dup2() function 433 
dynamic libraries 351, 568 


deadlocks 520 dynamic memory 565 

debugger, gdb 550 dynamic storage 276-280, 294 

decay 59 using the heap 278 
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E 


echo command 401 
ellipsis (...) 345 

email, sending from command line 449 
encrypt() function 352 
encryption, XOR 182 
enums 255, 260 

responses in mail merge program (example) 334 
tracking values stored in structs and unions 256-259 
environment variables 

parameters for execv(), execvp(), and execve() 
functions 406 

parameters for exel(), execlp(), and execle() functions 
405 

reading and passing to functions 407 
equality operator (==) 13 
err no variable 408 

error handling, avoiding writing duplicate code for system 
calls 434 

error messages 

converting err no into 408 

displaying when Standard Output is redirected 118 
Standard Error 120 
/ etc/services file 472 
.exe files (Windows) 10 
exec() functions 404, 427 

array functions, execv(), execvp(), and exe eve () 406 

failures of calls to 408 

important points about 411 

list functions, execl(), execlp(), and execle() 405 

many versions of 405 

order-generation program, Starbuzz coffee (example) 
412-415 

program searching many RSS feeds at once (example) 
418 

program termination after call to 420 

running child process with fork() and exec() 421—425 

running / sbin/ifeonfig or ipconfig (example) 409 


execle() function 407 
failures of 408 

program searching many RSS feeds at once (example) 
418 

executables 2, 185 
exit() function 434 

called by default signal handler for interrupt signal 
451 

important points about 441 
exit status of child process 439 
extern keyword 186 

F 

Feldman, Stuart 202 
fgets() function 450, 451 

as alternative to scanf() 67 
using for data input, scanf() versus 68 
file descriptors 431 

descriptor tables 441 
fileno() function 433 
files, making program work with 109 
filters 109 

find() function 313-315 

other types of searches 321 
floating-point numbers 159 

handling with floats and doubles 168 
float type 159 

casting to whole numbers 164 
defined 162 
finding size of 167 
fopen() function 138 

problem opening data stream 147 
fork() function 420, 427 

creating a process for each client 486 
important points about 426 

running child process with fork() + exec() 421—425 
calling fork() 423 
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for loops 30, 39 

format strings, passing to scanf() function 65 
formatted output, display by printf() function 6 
fprintf() function 122 

updating example mapping program to use 123 
freeaddrinfo() function 493 
free() function 279 

call interception by valgrind 308 
releasing memory with 280 
tracking calls to with valgrind 302 
fscanf() function 122 
functions 5, 311-350 

advanced, summary of important points 566 
Arduino 214 
find() function 313-315 
macros versus 346 
main() function 6 
no function data type in G 319 
operators versus 56 
order in a program 171 
order of running in a program 96 
passing as parameter to another function 317-324 
creating function pointers 320 
identifying function pointers 324 
passing code to 316 

passing pointer to variable as function parameter 47 
passing strings to 53 

passing struct to function that updates struct 238 
sorting data 325-342 

using function pointers to set sort order 326 
splitting declaration from definition 173, 561 
variables declared inside 43 
variadic 343—349 

writing example function 347—349 
void return type 33 
writing 32 


G 

game, Blasteroids project 523-538 
Allegro library 526 
asteroids 533 

blasting asteroids without being hit 525 
blasts fired by spaceship 532 
building the game 528 
finished product 536 
game status 534 
reading key presses 531 
spaceship 529 
spaceship behavior 530 
using transformations 535 
writing arcade game 524 
garbage collection, G and 294 
gcc 9 

finding standard header file directories 355 
GNU Compiler Collection 39 
interview with 22 
-I option 356 
optimizations 546 
standards supported 8 
warnings 547 
gcov (GNU Coverage) 550 
gdb (GNU Project Debugger) 550 
getaddrinfo() function 493 
GET command 490 
getenv() function 407 
getopt() function 149, 155 
gets() function, reasons not to use 67 
globals 

defined 80 

variables declared outside of functions 43 
global variables 96 
count 543 
errno 408 

storage in memory 47 
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GNU Compiler Collection. See gcc 
GNU Coverage (gcov) 550 
GNU Profiler (gprof) 550 
GNU Project Debugger (gdb) 550 
golden rules of failure 408 
gprof (GNU Profiler) 550 
grep command 443 
GTK library 551 

GUIs (graphical user interfaces), creating 551 


hardware, kernel and 403 
header files 

angle brackets in 354 
creating 174 
forgetting to include 96 
function declarations in 173 
quotes and angle brackets in 180 
for shared code 186 
sharing between programs 355 
heap 

allocating and releasing memory 289 
allocating storage for string copy 285 
defined 80 

differences from the stack 292 
important points about 294 
releasing memory when you’re done 279 
using for dynamic storage 278 
hexadecimal literals 261 

hexadecimals, converting between binary and 261 
hex format, memory addresses 48, 52 
•h files. See header files 
hostname 490 

HTTP (Hypertext Transfer Protocol) 469, 490 



IDE, Arduino 209 
if statements 14 

break statements and 31 
checking same value repeatedly 25 
replacing sequence of switch statement 27 
ignoring signals 459 
interrupt signal 456 
images 

converting image formats 449 
grabbing image from webcam 392 
#include directive 184, 542 
angle brackets in 354 
header files at different locations 356 
including header file in main program 174 
includes section, G programs 5 
increment operator (++) 13, 540 
indexes, array 13 
starting at 0 61 
indirection operator (*) 48 
infinite loops 39 
integers 159 

interprocess communication 429—466 

avoiding duplicate error-handling code for each 
system call 434 

catching signals and running your own code 452—456 

connecting processes with pipes 443 

death of a process 451 

duplicating data streams with dup2() 433 

examining a typical process 431 

finding RSS news stories and opening them in a 
browser 444—449 

getting descriptor with fileno() 433 

listening to child process directly 442 

processes redirecting themselves 432 
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program saving output of rssgossip.py script to file 435 
program testing math skills (example) 460—464 
questions and answers about 441 
redirecting input and output 430 
redirection replacing data streams 432 
resetting and ignoring signals 459 
sending alarm signal to processes 458 
summary of important points 570 
using kill command to send signals 457 
using raise() to send signals 457 
waitpid() function 438—440 
interrupt signal 451 
ignoring 456 
intruder detector 390 
finished product 394 
int type 159 

compiler assumption as return type for unknown 
functions 171, 181 

defined 162 

finding size of 167 

I/O (input/output) 

connecting input and output with a pipe 131—136 
displaying error messages when output is redirected 118 
output to more than one file 137 
redirecting 430 

redirecting output from display to files 109 
redirecting Standard Input with < operator 111 
redirecting Standard Output with > operator 112 
redirection 110 
ipconfig 409 

IP (Internet Protocol) 469 

IP (Internet Protocol) addresses 491 

converting domain names to 493 

creating socket for an IP address 492 

creation of sockets with IP addresses or domain names 
499 



JSON, displaying comma-separated data as 105 

K 

kernel 403 

keypresses, reading 531 

kill command, using to send signals 457 



LED 


G code writing to 212 
connecting to Arduino board 210 
libraries 

Allegro game development library 526 
GUI (graphical user interface) 551 
static and dynamic 568 
limits.h header, macros defined in 544 
linked lists 269 
creating 271 

creating and releasing heap memory 287—291 
inserting values into 273 
linking object code files 185, 191 
Linux. See also operating systems 
GTK GUI library 551 
listen() function 471 
listen queue for clients 471 
list functions, execl(), execlp(), and execle() 405 
local variables, storage in stack 47, 278 
locks 513 

creating a mutex lock 514 

deciding where to put locks in code (example) 516-519 
long keyword 164 
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LONG—MAX macro 544 
long type 159， 161 
defined 162 

passing long values to thread functions 515 
loops 

breaking out of with break statement 31 
continue statement in 31 
running forever, infinite loops 39 
structure of 30 

M 

Mac computers. See also operating systems 
Carbon library for GUIs 551 
script for talking to plants 215 
machine code 2, 185 
macros 139 
creating 542 
functions versus 346 
mail/mutt programs 449 
main() function 6 

with command-line arguments 141 
ending program with exit() instead of 441 
makefiles 200 

on different operating systems 202 
generation with autoconf tool 202 
make tool 198-205, 225 
additional features 548 
automating builds with 198 

converting Ogg Vorbis music file to Swing version 203 

different name on Windows 199 

how it works 199 

implicit rules to build files 549 

uses other than compiling code 202 


malloc() function 278 

asking for memory with 280 
call by strdup() function 294 
call interception by valgrind 308 
tracking calls to with valgrind 302 
memory 41, 565 
addresses 47 

allocating heap memory and releasing it 289 
G toolbox 81 

differences between the stack and the heap 292 
freeing by calling free() function 279, 280 
getting with malloc() function 278 
kernel control over 403 
order of segments in 79 
overview of computer memory 43 
and pointers 556 
questions and answers about 52 
requesting with malloc() function 280 
reuse of space with unions 247 
string literals stored in read-only memory 73 
structs stored in 226 
summary of segments 80 
memory leaks 279 

avoding when using data structures 296 
tracking and fixing using valgrind tool 302—308 
mingw32-make 199 

MinGW, spaces in command-line arguments 405 
mkfifo() function 450 
moisture sensor 
building 210 
G code reading from 212 
connecting to Arduino 211 
movement, detecting 393 
mutexes 513 

causing deadlocks 520 
creating a mutex lock 514 
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N 

named pipes 450 
nested structs 227 

network configuration, commands for 409 
networking. See sockets and networking 
NMAKE tool 199 
not operator (!) 18 

NULL value, following last command-line argument in 
exec() function parameters 405 

0 

object code 185 

saving copies into files 190 
object files, sharing between programs 355 
Objective-G 39, 551 
object orientation 39 
.o files 355. See also object code 

Ogg Vorbis music file, converting to Swing version 203 
OpenGV 389-394 

G code, what it should do 392 
defined 391 
finished product 394 
installing 391 
intruder detector 390 
operating systems 

commands to open a URL 446 
controlling programs with signals 451 
different sizes of data types on 167, 168 
GUI libraries for 551 
interview with 127 
kernel 403 

listing processes running on system 404 


makefiles and 202 

network configuration commands 409 
OpenGV 391 

registering new item in file descriptor table 433 
Standard Input and Standard Output 110 
system calls 398 
telnet program 468 
operators 540 

functions versus 56 
precedence of 240, 243 
optarg variable 149, 155 
optimization 546 
optind variable 149 
OR operator (I) 20, 541 
OR operator (| |) 18, 20 

P 

parameters, function 6, 32 
passing by value 238 
parent process 420, 450 

piped command on command line 443 
server 486 

partial compiles 191-196 
PATH variable 406 

including when passing environment variables on 
Gygwin 407 

performance, analyzing with gprof 550 
PIDs (Process Identifiers) 404 

pid_status parameter of waitpid() function 441 
pid_t in call to fork() 423 
waitpid() function parameters 439 
pipe() function 450 

connecting Standard Output of child and Standard 
Input of parent processes 444 
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pipes 

connecting input and output 131—136 

connecting output of rssgossip.py to input of program 
444-449 

connecting processes with 443 
important points about 450 
pointer arithmetic 

and array index starting at 0 61 
and data types of pointer variables 62 
important points about 64 
pointer notation with structs 241 
pointers 42 

address of variable in memory 43 
array of arrays versus array of pointers 98 
array variables as 54 

char pointers versus char arrays in data structure 286 
conversion to ordinary number 56 
G toolbox 81 

differences of array variables from 59 
file 433 

function 318—324, 324, 566 
arrays of 338—342 
creating 319 

summary of important points 342 
using to set sort order 326 
making it easier for functions to share memory 47 
passing pointer to variable as function parameter 47 
questions and answers about 52 
in recursive structures 271 
set to string literals, avoiding 76 
sizes on different computers 56 
and structs assigned to another variable 226 
to structs 239 

summary of important points 556 
types assigned to pointer variables 62 
using for data entry 65 
using to read and write data 48 


variables declared as function arguments 74 
void 506 

port, binding to 470 

port number for server application, caution in choosing 

472 

PO SIX libraries 149 
POSIX thread library (pthread) 506 
linking 508 
precompilation 180 
preprocessing 180 

fixing the source 184 
preprocessor directives 542 
printf() function 6 

reading from keyboard and writing to display 110 
variable number of arguments 343 
printing to data stream with fprintf() function 122 
private scope 543 

processes. See also interprocess communication 
cloning with fork() function 420 
communication, summary of important points 570 
control by kernel 403 
examining a typical process 431 
redirecting themselves 432 

replacement of current process using exec() functions 
404 

running child process with fork() + exec() 421—425 

server and client, creating processes for clients with 
fork() 486 

simple, doing one thing at a time 504 
speed of, threads versus 520 
using for simultaneous tasks, limitations of 503 
Process Identifiers. See PIDs 
profiling tools 550 
programs 

compiling and running 9 
complete G program 5 

exercise, matching candidate block of code with 
possible output 34, 36 
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protocols 469, 490 
ps -ef command 404 
pthread_create() function 507 
pthread_join() function 507 
PTHREAD—MUTEX_INITIALIZER macro 514 
pthread_mutex_lock() function 514 
pthread_mutex_unlock() function 514 
pthread (POSIX thread) library 506 
linking 508 
Python 

installing 416 
RSS Gossip script 416 

qsort() function 326 

R 

raise() command, sending signals with 457 
recursive structures 294, 564 
creating 271 
recv() function 478, 493 
redirection 110 

child process output to file 435—440 
descriptor table and 441 

displaying error messages when output is redirected 
118 

output from display to files 109 
processes redirecting themselves 432 
programs run from command line 430 
replacement of data streams 432 
several processes connected with pipes 136 
Standard Input, using < operator 111 
Standard Output, using > operator 112 
reference operator (&) 43, 48 
references, pointers versus 52 


reserved words in G 181 

return statements in functions 32, 39 

return type 6 

compiler assumptions for unknown functions 171 

void return type for thread functions 506 
return values, assignments 33 
reusing code 182 
RSS feeds 

program saving output of rssgossip.py script to file 435 

program searching many feeds at once (example) 
417-425 

running rssgossip.py in separate process for each 
feed 422 

reading news with 416 

reading story links from rssgossip.py script 442 

running rsscossip.py script and opening stories in 
browser 444 

RSS Gossip (Python script) 416 
running programs 9 



ifconfig program 409 

/ sbin/ifconfig program 409 

scanf() function 65, 79 

causing buffer overflows 66 

fgets() function as alternative to 67 

passing pointer to variable to scanf() 239 

using for data input, fgets() versus 68 

screen, redirecting data to, without using Standard 
Output 441 

security, system calls and 402 
send() function 472, 493 
sentinel character \0 12 
serial port, writing to (G code in Arduino) 212 
setitimer() function 459 
sharing code 182—187,355 
.h header files 356 
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short type 159, 161 
defined 162 

SHRT_MIN macro 544 

shunit2 tool, testing scripts and commands 545 

sigaction() function 453 

sigaction structs 452 

SIGALRM signal 458 

SIGKILL signal 457 

signals 451 

catching and running your own code 452—456 
ignoring 459 

matching to cause (example) 455 
order of sending and receiving 465 
program testing math skills (example) 460—464 
resetting to default handler 459 
sending using kill command 457 
sending using raise() 457 
signed values in binary 163 
SIGTERM signal 457 
single statement 14 

size limits for data types, macros determining 544 
sizeof operator 53, 56 

getting bytes in memory occupied by particular data 
type 280 

use on pointers and array variables 59 
using with fgets() function 67 
sleep() function 508 

alarm() function and 458 
small tools 

connecting input and output with a pipe 131—136 
converting data from one format to another 104—107 
designing, tips for 129 
different tasks need different tools 130 
flexibility of 128 
output to multiple files 137 
sockets and networking 467—500 

clients obtaining a socket and communicating 491 
client sockets, creating socket for a domain name 493 


client sockets, creation and connection to remote port 
492 

creation of sockets with IP addresses or domain names 
499 

G toolbox 500 

fork() a process for each client 486 

how servers talk to the Internet 470 

Internet knock-knock server (example) 468 

other useful server functions 479 

reading from the client 478 

server can only talk to one client at a time 485 

server code changed to fork child process for each 
client 487—489 

server generating random advice for clients (example) 
473 

sockets not your typical data streams 472 

summary of important points 572 

writing a web client 490, 494—498 

writing code for Internet knock-knock server (example) 
480-484 

sorting 325-342 

using function pointers to set sort order 326 

writing comparator functions for different sorts 
328-333 

source files 2 

compiling and running 9 

multiple files for code 561 

spaceship (Blasteroids game) 529 

behavior of 530 

stack 43 

defined 80 

differences from the heap 292 
storage in 278 
Standard Error 120, 558 

default output to display 121 
in descriptor table 432 
redirecting with 2> 122, 432 
standard header directories 355 
standard header files 180 
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Standard Input 122, 558 

connecting to Standard Output of another process 131 
in descriptor table 432 
redirecting 110 

redirecting with < operator 111 
Standard Output 558 

connecting to Standard Input of another process 131 
in descriptor table 432 
redirecting child process output to file 435 
redirecting to file 112, 430 
standards 2 

compiler support of 8 
designated initializers 248 
PO SIX libraries 149 
return statements in functions 32 
statements 14 
static keyword 543 
static libraries 351, 568 
stdarg.h header 345 
storage, flexible 268 
strcmp() function 331,333 
strdup() function 285 

calling malloc() function 294 

fixing create() function that uses dynamic allocation 286 
strerror() function 408 
string.h header file 86 

more information about functions in 95 
string literals 13 

char pointer set to, avoiding 76 
important points about 79 
inability to update 72 
strings 11, 83-102 

array of arrays versus array of pointers 98 

BE the Compiler exercise, jukebox program (example) 
91 

changing, using copy for 74 
as character arrays 12 
code shuffling letters in 69—72 


copying 285 

creating array of arrays 85 
crossword puzzle (example) 99 
G toolbox 101 

displaying string backward on screen 97 
ending with sentinel character \0 12 
passing to functions 53 
searching 84, 86 

Pool Puzzle example 90 
review of jukebox program (example) 94 
testing jukebox program (example) 95 
Standard Library, string.h 86-88 
arrays of, char** pointer to 320 
summary of important points 557 
using strstr() function 89 
strstr() function 89 
structs 217—246, 260, 274 
arrays versus 220, 225 
assignment 238 
benefits of using 221 
bitfields collected in 262 
creating aliases for with typedef 232 
designated initializers setting initial value of fields 249 
enums tracking values stored in 256-259 
holding sequence of single bits for yes/no values 261 
in memory 226 
nesting 227 
pointer notation 241 
pointers to 239 

reading fields with . (dot) operator 222 
recursive structures 271, 294 
summary of important points 562 
updating 236 

using bitfields in customer satisfaction survey 
(example) 264 

using with unions 249 

values separated with semicolon (;) 255 

wrapping parameters in 221 
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structured data types. See structs 
switch statements 26 

rewriting code to replace sequence of if statements 27 
summary of important points about 28 
symbols, storing in enums 255 
system calls 398, 427 
accept() function 471 

avoiding writing duplicate code for error handling 434 
checking for errors on 474—477 
exec() functions 404—410 
failures of 408 

order-generation program, Starbuzz coffee 
(example) 412—415 

program searching many RSS feeds at once 
(example) 418 

fork() function, cloning processes with 420 

getenv() function, reading environment variables 407 

important points about 411 

listen() function 471 

mkfifo() function 450 

running child process with fork() and exec() 421—426 
security breaches 402 
system() function 398, 426, 427 
exec() function versus 411 
opening a web page in a browser 446 

T 

tab character, beginning recipe lines for makefiles 200, 202 
target files 198 

describing in makefiles 200 
taskmgr command (Windows) 404 
tasks, sequential or parallel 502 
telnet program 468 
ternary operator (?:) 540 
testing, automated 545 


threads 501-522 
creating 506 

using pthread_create() 507 
G toolbox 521 

deciding where to put locks in code (example) 516 
519 

important points about 520 
multithreaded programs 505 
mutexes 513 

passing long values to thread functions 515 
program counting down beers (example) 509—511 
single threads of execution 504 
summary of important points 573 
thread safety in code 512 
using mutex to control execution 514 
timers for processes 459 
transformations 535 
true and false values 19 
typedef command 

creasting aliases for structs 232 
recursive structures and 271 

TJ 

unions 246, 260, 563 

enums tracking values stored in 256-259 
important points about 265 
reuse of memory space 247 
setting value of 248 
using with structs 249 
values separated with semicolon (;) 255 
values stored in, data types of 254 
unistd.h header 149 

unsigned keyword, prefixing data types with 164 

URLs, opening on various operating systems in web 
browser 446 
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V 

valgrind tool, using to find memory leaks 302—308 
values 

copied when assigning structs 238 

matching data type to type of variable it’s stored in 
163 

parameters passed to functions 238 
storing short-range values in bitfields 262 
variables 

matching data type for value stored in 163 
sharing among code files 186 
storage in memory 43 
using to shorten makefiles 548 
variadic functions 343—349 

writing example function 347—349 
virtual memory size 403 
void functions 33, 39 
void pointers 327, 506 

w 

waitpid() function 438—440 
important points about 441 
parameters 439 
warnings, gcc 547 

web browsers, opening a web page in 446 


websites for G 552 
WEXITSTATUS() macro 441 
while loops 29 

modifying in card counting program to keep running 
count 35, 37 

structure of 30 

summary of important points 39 
window, creating in OpenGV 393 
Windows systems. See also operating systems 

GreateProcess() function instead of fork() 426 
.exe files 10 

fork() function and 420, 426 

GUI libraries 551 

ipconfig command 409 

listing processes running on system 404 

make tools 199 

telnet program, built-in versus Gygwin versions 468 

X 

XOR encryption 182 

XOR operator, bitwise XOR ( A ) 541 
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